ActivationKing MCP

Connect your AI assistant to your ActivationKing account.

ActivationKing runs photo booths, AI experiences and games at live events. This MCP server lets an AI agent (Claude, Cursor, and other MCP clients) read your own ActivationKing data and manage your Ops Calendar: look up events and guest sessions, check credits, and create or update companies, event jobs and deals, for example to push a deal won in your CRM straight into Ops as a job.

This repository holds the connection guide, a Claude Code plugin and the MCP Registry manifest. The server itself is hosted by ActivationKing; there is nothing to install or run.

1. Get an API key

1. Sign in at activationking.com/dashboard/api-keys.

2. Create a key. It starts with ak_live_ and is shown once.

3. Store it as an environment variable rather than pasting it into config files:

# macOS / Linux
export ACTIVATIONKING_API_KEY="ak_live_..."

# Windows (persists for new terminals)
setx ACTIVATIONKING_API_KEY "ak_live_..."

A key only sees the data of the user who created it. Ops Calendar tools additionally follow that user's role in each organization.

Related MCP server: ghl-mcp-server

2. Connect your client

Claude Code: plugin (recommended)

The plugin adds the server and a skill that teaches Claude how to use the tools safely.

/plugin marketplace add activationking/activationking-mcp
/plugin install activationking@activationking

Make sure ACTIVATIONKING_API_KEY is set in the environment Claude Code starts from.

Claude Code: server only

claude mcp add --transport http activationking https://api.activationking.com/mcp \
  --header "Authorization: Bearer ${ACTIVATIONKING_API_KEY}"

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "activationking": {
      "url": "https://api.activationking.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ACTIVATIONKING_API_KEY}"
      }
    }
  }
}

Claude Desktop

Claude Desktop's config file starts local servers, so use the mcp-remote bridge (requires Node.js). Edit claude_desktop_config.json:

{
  "mcpServers": {
    "activationking": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.activationking.com/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer ak_live_..."
      }
    }
  }
}

Other MCP clients

Any client that supports Streamable HTTP with a custom header works: point it at https://api.activationking.com/mcp and send Authorization: Bearer <your key>.

Web connectors (claude.ai, ChatGPT): these add remote servers through an OAuth sign-in. ActivationKing MCP currently authenticates with API keys only, so web connectors cannot connect yet. Use one of the clients above.

3. What you can do

Try prompts like:

• "List my events from last month and show the session count for each."

• "How many prints and AI credits did the event Summer Launch use?"

• "What's my AI credit balance?"

• "Create this CRM deal as an Ops job: client Acme, photo booth, 14–15 March in Berlin, price 2,400 EUR."

• "Move the Acme job's deal to Won and add a line for an extra print station."

Tools

The authoritative, always up-to-date list with every parameter is in llms.txt and llms-full.txt. In short:

How the Ops tools work:

• Organization: Ops tools take an organizationId. Call get_account to see the organizations you belong to.

• Reference values: phases, event and venue types, member ids, products and deal statuses come from ops_reference_data.

• Sync from your CRM without duplicates: pass externalSource + externalId (your system's id) to ops_save_company / ops_save_job. The first call creates the record; later calls with the same pair update it.

• Partial updates: only the fields you pass change.

• New jobs open a deal automatically; use ops_update_deal to set its status, currency and price lines.

• Permissions follow your role in the organization (for example, deals need Deal.View / Deal.Edit). The organization needs an Ops Calendar subscription; without one, Ops tools return an error.

• Write tools are annotated (readOnlyHint / destructiveHint), so MCP clients ask for confirmation before calling them.

Security

• Treat your API key like a password. Never commit it, paste it into shared configs or put it in a prompt.

• Prefer environment variables (as in the examples above).

• If a key leaks, revoke it at activationking.com/dashboard/api-keys and create a new one.

• Review write actions (create, update, delete) before approving them in your client.

Support

• API reference: api.activationking.com/docs

• Issues with this repository: open a GitHub issue.

• Account or data questions: contact ActivationKing support via activationking.com.

License

MIT