canx-mcp-server

Give your AI agent direct access to the CANX platform.

Manage campaigns, extensions, and analytics — all from your IDE.

What is this?

An MCP server that connects AI coding assistants (Cursor, Cline, Claude Desktop, Windsurf) to the CANX advertising platform. Your agent can create campaigns, register extensions, check balances, and pull analytics without you ever opening the dashboard.

Tools

| Tool | Type | Description | |------|------|-------------| | canx_get_balance | read | Advertiser & developer wallet balance | | canx_list_campaigns | read | All campaigns with impressions, clicks, CTR, spend | | canx_post_campaign | write | Create a new campaign (auto-submits for approval) | | canx_pause_campaign | write | Pause or resume a running campaign | | canx_get_analytics | read | Last 7 days — impressions, clicks, CTR | | canx_list_extensions | read | All registered extensions with status & SDK keys | | canx_get_extension | read | Full extension metadata (ratings, version, size, etc.) | | canx_post_extension | write | Register a new extension (starts in Sandbox) |

Setup

1. Add to your MCP config

Drop this into your client's MCP configuration file:

{
  "mcpServers": {
    "canx": {
      "command": "npx",
      "args": ["-y", "canx-mcp-server"],
      "env": {
        "CANX_USER_ID": "your-user-id"
      }
    }
  }
}

{
  "mcpServers": {
    "canx": {
      "command": "npx",
      "args": ["-y", "canx-mcp-server"],
      "env": {
        "CANX_USER_ID": "your-user-id"
      }
    }
  }
}

{
  "mcpServers": {
    "canx": {
      "command": "npx",
      "args": ["-y", "canx-mcp-server"],
      "env": {
        "CANX_USER_ID": "your-user-id"
      }
    }
  }
}

2. Set your User ID

Your CANX_USER_ID is visible in the Developer Dashboard under your profile. This scopes all operations to your account.

3. That's it

Restart your AI client. The tools will appear automatically.

Environment Variables

| Variable | Required | Default | Description | |----------|:--------:|---------|-------------| | CANX_USER_ID | ✅ | — | Your CANX platform user ID | | SUPABASE_URL | — | Production URL | Override the Supabase endpoint | | SUPABASE_ANON_KEY | — | Production key | Override the Supabase anon key |

Local Development

cd canx-mcp
npm install
npm run dev        # runs with tsx (hot reload)
npm run build      # compiles to dist/
npm start          # runs compiled output

Example Prompts

Once connected, try asking your AI agent:

"Check my CANX balance" "List all my campaigns and their performance" "Create a new banner campaign for my productivity tool with a $25 budget" "Pause the Summer Sale campaign" "Register my new extension called 'Tab Manager Pro'"

Tech

• Runtime — Node.js (ES2022)
• Protocol — MCP over stdio
• Database — Supabase (canx_* tables)
• Auth — User ID scoped (all queries filtered by CANX_USER_ID)

License

MIT