MCP Servers

Anima exposes 53 specialized tools via the Model Context Protocol (MCP), giving AI assistants direct access to agent email, vault, phone, voice calls, identity cards, and more. Tools are organized into domain servers, so you can install only what you need:

Server	Package	Description
Agent	`@anima-labs/mcp-agent`	Agent lifecycle, organizations
Email	`@anima-labs/mcp-email`	Email, messages, domains, addresses
Phone	`@anima-labs/mcp-phone`	Phone numbers, SMS, voice calls
Cards	`@anima-labs/mcp-cards`	Agent cards and identity metadata
Vault	`@anima-labs/mcp-vault`	Encrypted credential storage, security policies
Platform	`@anima-labs/mcp-platform`	Webhooks, pods, utilities

Quick Start

Option A: Local (stdio)

Run one or more servers locally via npx:

npx @anima-labs/mcp-phone --api-key=ak_...

Option B: Hosted (remote)

Connect to Anima’s hosted MCP endpoint — no local install needed:

https://mcp.useanima.sh/mcp

Authenticate with your API key as a Bearer token (Authorization: Bearer ak_...). The hosted endpoint exposes the full tool surface, so there is nothing to install or keep updated.

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json: Local (stdio):

{
  "mcpServers": {
    "anima-phone": {
      "command": "npx",
      "args": ["-y", "@anima-labs/mcp-phone"],
      "env": {
        "ANIMA_API_KEY": "ak_..."
      }
    },
    "anima-email": {
      "command": "npx",
      "args": ["-y", "@anima-labs/mcp-email"],
      "env": {
        "ANIMA_API_KEY": "ak_..."
      }
    }
  }
}

Hosted (remote via mcp-remote bridge):

{
  "mcpServers": {
    "anima-phone": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.useanima.sh/mcp",
        "--header", "Authorization:${ANIMA_TOKEN}"
      ],
      "env": {
        "ANIMA_TOKEN": "Bearer ak_..."
      }
    }
  }
}

Cursor

Hosted (remote — native HTTP support):

{
  "mcpServers": {
    "anima-phone": {
      "url": "https://mcp.useanima.sh/mcp",
      "headers": {
        "Authorization": "Bearer ak_..."
      }
    }
  }
}

Claude Code

# Local
claude mcp add anima-phone -- npx -y @anima-labs/mcp-phone

# Hosted
claude mcp add anima-phone --transport http \
  --url https://mcp.useanima.sh/mcp \
  --header "Authorization: Bearer ak_..."

VS Code

Add to .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "anima-phone": {
        "type": "http",
        "url": "https://mcp.useanima.sh/mcp",
        "headers": {
          "Authorization": "Bearer ${input:anima-key}"
        }
      }
    },
    "inputs": [
      {
        "id": "anima-key",
        "type": "promptString",
        "description": "Anima API Key",
        "password": true
      }
    ]
  }
}

CLI Setup (all clients)

The Anima CLI can auto-configure all detected MCP clients:

# Install for all detected clients (local mode)
anima setup-mcp install --all

# Install specific server for a specific client (remote mode)
anima setup-mcp install --client cursor --mode remote --server phone

# Install all servers
anima setup-mcp install --all --server all

Environment Variables

Variable	Description
`ANIMA_API_KEY`	Your Anima API key (required)
`ANIMA_API_URL`	Custom API base URL (optional)

Available Tools by Server

mcp-agent

Category	Tools	Description
Agent	create, list, get, delete, rotate-key	Manage AI agent identities
Organization	get, update, create, delete, rotate-key	Organization settings

mcp-email

Category	Tools	Description
Email	send, reply, search, list	Send and manage email
Message	send, list, get	Inbox messaging operations
Domain	create, verify, list, delete	Custom email domain management
Address	create, list, get	Email address management

mcp-phone

Category	Tools	Description
Phone	search, provision, list, release, send-sms	Phone number and SMS management
Voice	catalog, call, list-calls, get-call, transcript, summary, score	Voice call operations and intelligence

mcp-cards

Category	Tools	Description
Cards	get, publish, verify	Agent card and identity metadata

mcp-vault

Category	Tools	Description
Vault	provision, create, get, search, list, delete	Encrypted credential storage
Security	policies, audit, update	Security policy configuration

mcp-platform

Category	Tools	Description
Webhook	set (upsert), get, list, delete, test	Real-time event subscriptions, with endpoint auth and delivery throttle
Pod	create, list, get	Pod management
Utility	search, status, health	Utility and status tools

Legacy Monolith Server

The original monolith @anima-labs/mcp package is still supported but deprecated. Migrate to the split servers for better performance and selective loading.

Example Usage

Once connected, ask your AI assistant natural language questions:

“Send an email from my agent to user@example.com” → mcp-email
“Store my CRM login credentials in the vault” → mcp-vault
“Text me now from my agent’s number” → mcp-phone
“Make a voice call to +1-555-0123” → mcp-phone

For editor-specific setup, see Connect your AI client.

​MCP Servers

​Quick Start

​Option A: Local (stdio)

​Option B: Hosted (remote)

​Configuration

​Claude Desktop

​Cursor

​Claude Code

​VS Code

​CLI Setup (all clients)

​Environment Variables

​Available Tools by Server

​mcp-agent

​mcp-email

​mcp-phone

​mcp-cards

​mcp-vault

​mcp-platform

​Legacy Monolith Server

​Example Usage