AMPLIS MCP Server

Connect Claude, Cursor, and other AI tools to your live AMPLIS consulting data -- projects, people, clients, timesheets, knowledge base, and more.

Quick Start

1. Authenticate

npx @amplis/mcp-server login

Your browser will open for secure authentication via your AMPLIS account. Credentials are stored at ~/.amplis/credentials.json with strict file permissions.

Alternatively, paste an API key manually:

npx @amplis/mcp-server login-key

2. Configure Your AI Tool

Claude Desktop -- add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "amplis": {
      "command": "npx",
      "args": ["-y", "@amplis/mcp-server"]
    }
  }
}

Claude Code (CLI):

claude mcp add amplis npx @amplis/mcp-server

Cursor -- add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "amplis": {
      "command": "npx",
      "args": ["-y", "@amplis/mcp-server"]
    }
  }
}

What's Included

| Type | Count | Examples | |------|-------|---------| | Tools | 35 | Create tasks, log time, manage clients, search knowledge, track credentials, store memories, log decisions | | Resources | 36 | Projects, pipeline, people, clients, timesheets, capabilities, availability, utilization, knowledge base | | Prompts | 13 | Weekly status, project health, compliance check, meeting prep, invoice draft, risk assessment |

CLI Commands

npx @amplis/mcp-server login       # Browser-based login (recommended)
npx @amplis/mcp-server login-key   # Paste API key manually
npx @amplis/mcp-server status      # Show authentication status
npx @amplis/mcp-server logout      # Remove stored credentials
npx @amplis/mcp-server help        # Show help

Environment Variables

| Variable | Description | |----------|-------------| | AMPLIS_ORG_ID | Override org ID (skips credentials file -- useful for CI/Docker) | | AMPLIS_USER_ID | Override user ID for audit logging | | AMPLIS_API_URL | API base URL (default: https://app.amplis.com.au) |

Security

• API keys follow the format amplis_ + 64 hex characters (32 random bytes)
• Keys are SHA-256 hashed before storage in the database -- the full key is shown once at creation
• Local credentials stored with 0600 file permissions (owner read/write only)
• Browser login uses state tokens for CSRF protection
• Keys support permission scopes: read, write, admin
• Keys can be rotated atomically in the AMPLIS web app under Settings

Documentation

Full API reference with all tools, resources, and prompts: amplis.com.au/docs

License

MIT