MCP Server
The Anima MCP server exposes over 77 specialized tools via the Model Context Protocol, giving AI assistants like Claude direct access to your agent email, virtual cards, vault, phone numbers, and more — all from natural language.
Installation
Run the MCP server directly with npx:
npx @anima-labs/mcp --api-key=ak_...
Configuration
Configure your MCP client
Follow the instructions for your client below.
Set your API key
Set ANIMA_API_KEY in your environment or pass it as the --api-key flag.
Restart your client
Restart Claude Desktop or your MCP client to pick up the new server.
Claude Desktop
Add the following to your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"anima": {
"command": "npx",
"args": ["-y", "@anima-labs/mcp"],
"env": {
"ANIMA_API_KEY": "ak_..."
}
}
}
}
Claude Code
claude mcp add anima -- npx -y @anima-labs/mcp
Environment variables
| Variable | Required | Description |
|---|
ANIMA_API_KEY | Yes | Your Anima API key |
ANIMA_BASE_URL | No | Custom API base URL (override for self-hosted deployments) |
| Category | Tools | Description |
|---|
| Agent | create, list, get, delete | Manage AI agent identities |
| Email | send, search, list | Send and manage email messages |
| Message | send, list, get | Inbox messaging operations |
| Cards | create, list, freeze, policies | Virtual card issuing and management |
| Vault | provision, create, get, search | Encrypted credential storage |
| Phone | provision, send-sms, list | Phone numbers and SMS |
| Webhook | create, list, delete | Real-time event subscriptions |
| Domain | create, verify, list | Custom email domain management |
| Invoice | create, list, match | Invoice tracking and reconciliation |
| Funding | list, create | Funding source management |
| Security | policies, audit | Security policy configuration |
| Organization | get, update | Organization settings |
| Browser Payments | detect, fill, pay | Automated checkout form filling |
| x402 | payment protocols | HTTP 402 payment protocol tools |
| Utility | misc helpers | Search, status, and utility tools |
--tools:
npx @anima-labs/mcp --tools=email,cards,vault
Limiting tool categories is useful when you want to scope an assistant to a specific task — for example, only allowing card and invoice operations for a finance workflow.
Transport modes
The MCP server supports two transport modes:
Use stdio for local clients like Claude Desktop. This is the default — no extra flags required. Use HTTP transport for web-based or remote MCP clients.npx @anima-labs/mcp --transport=http --port=3100
Example prompts
Once connected, ask your AI assistant natural language questions and it will automatically select and call the appropriate Anima MCP tools:
- “Send an email from my agent to user@example.com”
- “Create a virtual card with a $50 daily limit”
- “Store my CRM login credentials in the vault”
- “List all transactions on card **** 4242”
- “Search my inbox for emails about invoices”
