Skip to main content

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 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

1

Configure your MCP client

Follow the instructions for your client below.
2

Set your API key

Set ANIMA_API_KEY in your environment or pass it as the --api-key flag.
3

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

VariableRequiredDescription
ANIMA_API_KEYYesYour Anima API key
ANIMA_BASE_URLNoCustom API base URL (override for self-hosted deployments)

​
Available tool categories

The MCP server exposes tools across 15 categories. By default, all categories are loaded.
CategoryToolsDescription
Agentcreate, list, get, deleteManage AI agent identities
Emailsend, search, listSend and manage email messages
Messagesend, list, getInbox messaging operations
Cardscreate, list, freeze, policiesVirtual card issuing and management
Vaultprovision, create, get, searchEncrypted credential storage
Phoneprovision, send-sms, listPhone numbers and SMS
Webhookcreate, list, deleteReal-time event subscriptions
Domaincreate, verify, listCustom email domain management
Invoicecreate, list, matchInvoice tracking and reconciliation
Fundinglist, createFunding source management
Securitypolicies, auditSecurity policy configuration
Organizationget, updateOrganization settings
Browser Paymentsdetect, fill, payAutomated checkout form filling
x402payment protocolsHTTP 402 payment protocol tools
Utilitymisc helpersSearch, status, and utility tools

​
Selective tool loading

To reduce the tool surface area exposed to your AI assistant, pass a comma-separated list of categories with --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.
npx @anima-labs/mcp

​
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”