Ambassly MCP server

Connect an AI coding assistant to Ambassly with a scoped API key. Company keys can operate the merchant dashboard; affiliate keys can operate the creator portal.

The live guide with full Claude Code, Claude Desktop, and Cursor config lives at docs/mcp.

Endpoint and auth

Streamable HTTP endpoint: https://ambassly.com/api/mcp

Mint a key in Dashboard or Portal settings, then send it as a bearer token:

Authorization: Bearer amb_YOUR_API_KEY

Claude Code

claude mcp add --transport http ambassly https://ambassly.com/api/mcp \
  --header "Authorization: Bearer amb_YOUR_API_KEY"

Cursor

{
  "mcpServers": {
    "ambassly": {
      "url": "https://ambassly.com/api/mcp",
      "headers": {
        "Authorization": "Bearer amb_YOUR_API_KEY"
      }
    }
  }
}

Tools

Company key tools: list_programs, get_program_stats, list_pending_commissions, approve_commission, reject_commission, create_affiliate_invite, get_payout_batch.

Affiliate key tools: my_stats, my_links, create_link.

API keys are shown once. Ambassly stores only a SHA-256 hash, plus a short prefix so you can recognize and revoke keys later.

For the full Claude Desktop config and example session, see docs/mcp.