Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Anima MCP Server Send an email to contact@example.com about the project update."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP (Model Context Protocol) server for Anima -- 54 tools across 9 categories for AI agent communication, identity, and security.
Anima runs a hosted MCP gateway at https://mcp.useanima.sh/mcp -- nothing to install, always current, and it carries the fullest tool surface (it adds inbox management and other tools beyond this package's 54). If your client speaks remote MCP (Cursor, VS Code, Claude Code --transport http), point it there with Authorization: Bearer ak_... and you're done. See the MCP docs.
This npm package is the stdio bridge for clients without remote-MCP support and for pinned/air-gapped configs. Same platform, same auth, smaller tool set.
anima setup-mcp install --all # hosted gateway (default)
anima setup-mcp install --all --mode stdio # this packageRelated MCP server: Twilio SMS MCP Server
npm install @anima-labs/mcp
# or
bun add @anima-labs/mcp# stdio mode (default -- for Claude Desktop, Cursor, Windsurf, etc.)
npx @anima-labs/mcp
# HTTP mode (for web integrations)
npx @anima-labs/mcp --http --port=8014
# Selective tool loading (only register specific groups)
npx @anima-labs/mcp --tools=email,vault,phoneVariable | Required | Description |
| No | API server URL (default: |
| Yes | Agent API key ( |
| No | Master key ( |
Use the --tools flag to load only the tool groups you need. This reduces the tool count exposed to the LLM, which can improve tool selection accuracy and reduce token usage.
npx @anima-labs/mcp --tools=email,vault,phoneAvailable tool groups:
Group | Description |
| Account overview and usage rollups |
| Agent CRUD and address/identity management |
| Email send/receive, threads, drafts, attachments |
| Custom sending domains: DNS, verification, zone files |
| Phone number provisioning and release |
| Outbound calls, transcripts, recordings, voices |
| SMS/MMS send and conversation history |
| Credential vault management and TOTP |
| Webhook subscription management and testing |
If --tools is not provided, all groups are registered (current default behavior).
Run the MCP server over HTTP instead of stdio for web integrations:
npx @anima-labs/mcp --http --port=8014The server listens at http://localhost:8014/mcp and expects a Bearer <api-key> authorization header on each request.
~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"anima": {
"command": "npx",
"args": ["-y", "@anima-labs/mcp"],
"env": { "ANIMA_API_KEY": "ak_..." }
}
}
}With selective loading:
{
"mcpServers": {
"anima": {
"command": "npx",
"args": ["-y", "@anima-labs/mcp", "--tools=email,vault,phone"],
"env": { "ANIMA_API_KEY": "ak_..." }
}
}
}.cursor/mcp.json:
{
"mcpServers": {
"anima": {
"command": "npx",
"args": ["-y", "@anima-labs/mcp"],
"env": { "ANIMA_API_KEY": "ak_..." }
}
}
}.windsurf/mcp.json:
{
"mcpServers": {
"anima": {
"command": "npx",
"args": ["-y", "@anima-labs/mcp"],
"env": { "ANIMA_API_KEY": "ak_..." }
}
}
}Tool | Description |
| Single-call workspace snapshot: context, send-capability flags, inventory counts, and blockers |
| Usage rollup for a billing period |
Tool | Description |
| Create a new agent, optionally with metadata and an initial address |
| Get full detail for an agent: settings, metadata, status, addresses, and identities |
| List agents in the current account context with cursor pagination |
| Update an agent's name or metadata, and add/update/delete an address |
| Delete an agent by ID |
Tool | Description |
| Send a new outbound email from the agent mailbox |
| Get full detail for a single email by ID, including metadata and body |
| List emails newest-first with cursor pagination, optionally scoped to one agent |
| Search email by meaning (semantic vector search) or literal keyword |
| Reply to an existing email thread with correct threading headers |
| Forward an existing email to another recipient |
| Fetch all messages in one or more email threads |
| Get a temporary download URL for an email attachment |
| Create a new email draft (composed but not sent) |
| Get full detail for a single draft by ID |
| List email drafts with optional filters |
| Send a draft |
| Discard a draft |
Tool | Description |
| Register a custom sending domain in the workspace |
| Trigger a verification check after DNS records are configured |
| Get full detail for a domain, including verification and config state |
| List all domains connected to the current workspace |
| Update mutable configuration on a domain |
| Delete a domain from the workspace |
| Get the full DNS zone file for a domain |
Tool | Description |
| List provisioned phone numbers, optionally filtered by agent |
| Provision a new phone number and assign it to an agent |
| Release a provisioned phone number back to the carrier pool |
Tool | Description |
| Initiate an outbound phone call from an agent (returns a callId immediately) |
| List phone calls with optional filters |
| Get full detail for a call: status, duration, participants, AI summary, and quality score |
| Get the full transcript with speaker labels, timestamps, and confidence scores |
| Get a time-limited download URL for a call recording (WAV) |
| List available AI voices for placing phone calls |
Tool | Description |
| Send an SMS, or an MMS by passing |
| Get full detail for a single SMS by ID (includes its |
| List SMS messages with optional filters |
| List SMS conversations |
| Get a specific SMS conversation with message history |
Tool | Description |
| Provision a credential vault for an agent |
| List credentials in an agent vault with optional type filter |
| Get a single vault credential by ID |
| Create a new credential in an agent vault |
| Update an existing vault credential by ID |
| Delete a credential from vault storage by ID |
| Search vault credentials by keyword across names and content |
| Get the current TOTP code for a credential with a TOTP secret |
Tool | Description |
| Create or update a webhook subscription |
| Get a webhook subscription by ID |
| List webhook subscriptions with cursor pagination |
| Delete a webhook subscription by ID |
| Send a test event to verify endpoint reachability and signature verification |
Every tool here is a thin client over the Anima REST API, which makes two lies easy
to ship and nearly impossible to notice — both return a green 200:
a tool calling a route the API doesn't have, and
a tool advertising a parameter its route ignores (the API validates with Zod, which strips unknown input, so the server answers as if nothing was wrong and the model believes its filter was applied).
Two CI gates in src/__tests__/integration/contract-parity.test.ts make both
impossible. They check src/tool-routes.ts — where each tool declares the routes
it calls and any param it handles client-side — against
src/__tests__/fixtures/contract-routes.json, a snapshot of the real
@anima/contracts route surface.
Adding or changing a tool means updating its entry in src/tool-routes.ts.
If a gate fails, fix the tool: editing the declaration to match a lie, or parking a
param in clientParams, re-opens the exact hole the gates close.
Refreshing the snapshot (needs a checkout of the anima monorepo — it is private, so CI cannot do this for you):
bun run contracts:refresh -- --anima ../anima # rewrite the snapshot
bun run contracts:check -- --anima ../anima # diff only; non-zero on driftJoin the Anima Discord to ask questions in #mcp, share what you're building in #showcase, and stay up to date with releases in #announcements.
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Communication stack for AI agents: SMS, AI voice calls, phone numbers, and account events.
Email for AI agents — send, receive as a webhook, manage domains, templates, routing.
40+ Lightning-paid AI tools for agents: calls, SMS, fax, voice, translation. No signup, no keys.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/anima-labs-ai/mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server