> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useanima.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Servers

> Connect Anima to Claude Desktop, Cursor, VS Code, and other MCP clients via Model Context Protocol.

# MCP Servers

Anima exposes 53 specialized tools via the [Model Context Protocol](https://modelcontextprotocol.io) (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, identity, registry, A2A |
| **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`:

```bash theme={null}
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):**

```json theme={null}
{
  "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):**

```json theme={null}
{
  "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):**

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

### Claude Code

```bash theme={null}
# 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`:

```json theme={null}
{
  "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:

```bash theme={null}
# 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      |
| **Identity**     | create, list, get, verify               | Agent identity management  |
| **Registry**     | register, search, get, list             | Agent registry / discovery |
| **A2A**          | send, receive, list                     | Agent-to-agent messaging   |

### 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](mailto: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](/integrations).