Skip to main content
The Animam MCP server is a remote server, reachable over HTTP (SSE transport): 
https://mcp.animam.ai/mcp/sse
Authentication is a Bearer token (an Animam API token, or an OAuth access token). No package to install — point any MCP client at the endpoint.

​
Prerequisites

  • An Animam API token with the scopes you need — create one in the dashboard under Settings → API tokens (https://app.animam.ai). Tokens look like ak_….
  • An MCP client (Claude Code, Claude Desktop, Cursor, claude.ai, …).

​
claude.ai (web)

Add a custom connector pointing at the endpoint; claude.ai runs the OAuth flow against api.animam.ai (the server advertises it via /.well-known/oauth-protected-resource).
  1. Settings → Connectors → Add custom connector
  2. URL: https://mcp.animam.ai/mcp/sse
  3. Authorize.

​
Claude Code / Claude Desktop / Cursor

These clients run local commands, so bridge to the remote server with the published mcp-remote shim. Add to your client’s MCP config (e.g. ~/.claude/settings.json for Claude Code): 
{
  "mcpServers": {
    "animam": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.animam.ai/mcp/sse",
        "--header", "Authorization: Bearer ak_your_token"
      ]
    }
  }
}
Restart the client to load the server.
A first-party stdio package (@animam/mcp) is planned so you can run npx @animam/mcp directly instead of the mcp-remote shim. Until it ships, use the remote endpoint as shown above.

​
Token scopes

Scopes gate which tools a token can call. Create the token with what you need:
GoalScopes
Full access*
Manage the bot & widgetsettings:read, settings:write
Manage knowledge basecorpus:read, corpus:write
Manage segmentssegments:read, segments:write
Builder bots & analyticssettings:write, corpus:write, stats:read
Read-onlysettings:read, corpus:read, segments:read
A tool fails with a Missing scope: … message if the token lacks its required scope — see each tool’s required scope in MCP tools.

​
Verification

Once connected, ask your client: 
You: Show my Animam tenant configuration.
Claude: (calls get_tenant) Bot name "Aria", primary color #2563EB, …
or check the endpoint directly: 
curl https://api.animam.ai/tenants/your-slug \
  -H "Authorization: Bearer ak_your_token"

​
Troubleshooting

​
401 Unauthorized

The token is missing, malformed, or revoked. Confirm the Authorization: Bearer ak_… header is set, and that the token is active in Settings → API tokens.

​
Tools missing

The token lacks the required scope. For example, update_tenant needs settings:write; a corpus:read-only token won’t see write tools. Re-issue the token with the right scopes.

​
Local development

The server lives in the monorepo at apps/mcp (Express + SSE, port 3302). Run it with pnpm dev:mcp and point your client at http://localhost:3302/mcp/sse.