Skip to main content

​
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:
ServerPackageDescription
Agent@anima-labs/mcp-agentAgent lifecycle, organizations, identity, registry, A2A
Email@anima-labs/mcp-emailEmail, messages, domains, addresses
Phone@anima-labs/mcp-phonePhone numbers, SMS, voice calls
Cards@anima-labs/mcp-cardsAgent cards and identity metadata
Vault@anima-labs/mcp-vaultEncrypted credential storage, security policies
Platform@anima-labs/mcp-platformWebhooks, 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

VariableDescription
ANIMA_API_KEYYour Anima API key (required)
ANIMA_API_URLCustom API base URL (optional)

​
Available Tools by Server

​
mcp-agent

CategoryToolsDescription
Agentcreate, list, get, delete, rotate-keyManage AI agent identities
Organizationget, update, create, delete, rotate-keyOrganization settings
Identitycreate, list, get, verifyAgent identity management
Registryregister, search, get, listAgent registry / discovery
A2Asend, receive, listAgent-to-agent messaging

​
mcp-email

CategoryToolsDescription
Emailsend, reply, search, listSend and manage email
Messagesend, list, getInbox messaging operations
Domaincreate, verify, list, deleteCustom email domain management
Addresscreate, list, getEmail address management

​
mcp-phone

CategoryToolsDescription
Phonesearch, provision, list, release, send-smsPhone number and SMS management
Voicecatalog, call, list-calls, get-call, transcript, summary, scoreVoice call operations and intelligence

​
mcp-cards

CategoryToolsDescription
Cardsget, publish, verifyAgent card and identity metadata

​
mcp-vault

CategoryToolsDescription
Vaultprovision, create, get, search, list, deleteEncrypted credential storage
Securitypolicies, audit, updateSecurity policy configuration

​
mcp-platform

CategoryToolsDescription
Webhookset (upsert), get, list, delete, testReal-time event subscriptions, with endpoint auth and delivery throttle
Podcreate, list, getPod management
Utilitysearch, status, healthUtility 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
  • “Register my agent in the public registry” → mcp-agent
For editor-specific setup, see Connect your AI client.