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.

Endpoint and auth

The MCP endpoint is Streamable HTTP at 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"

Claude Desktop

Claude Desktop commonly connects remote HTTP MCP servers through mcp-remote.

{
  "mcpServers": {
    "ambassly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "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(program)
list_pending_commissions
approve_commission(id)
reject_commission(id, reason)
create_affiliate_invite(program, email)
get_payout_batch

Affiliate key tools

my_stats
my_links
create_link(program, label, destination_url)

Example session

User: Show pending commissions and approve the ones past hold.
Assistant: calls list_pending_commissions
Assistant: reviews hold_until and calls approve_commission for eligible ids
Assistant: summarizes approved totals and leaves non-eligible rows pending

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