How do I install Anima?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Anima need an API key?

No required environment variable is listed on this record.

When was Anima last checked?

Last checked 2026-11-09. Give your AI agent an identity it owns: email inbox, US phone number, SMS, voice, and a vault.

Anima MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.useanima.sh/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.anima-labs-ai-anima https://mcp.useanima.sh/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.anima-labs-ai-anima": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.useanima.sh/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

@anima-labs/mcp-server

The hosted MCP server behind https://mcp.useanima.sh — the recommended way to connect AI assistants to Anima. It exposes the full tool surface (66 tools today) over streamable HTTP with Authorization: Bearer <ak_… or mk_…>.

This package is deliberately not published to npm: it is the deployed gateway. For a local/stdio server use @anima-labs/mcp (published, 53 core tools) — same platform, same auth. Client setup for both lives in the MCP docs, or run anima setup-mcp.

Endpoints

One gateway, scoped mounts. /mcp carries everything; the per-domain mounts serve tailored connections with a smaller tool count:

/mcp — all tools (recommended)
/agent — agent lifecycle (create/get/list/update/delete)
/email — Anima agent mailboxes: inbox create/get/list/update/delete, send/reply/forward, threads, drafts, attachments, custom domains (agents.useanima.sh addresses or your own domain — no Gmail/SMTP relay involved)
/phone — phone number provisioning, SMS threads, voice calls + transcripts/recordings (Telnyx-backed)
/platform — account/usage overviews and webhook management
/vault — encrypted credential vault: CRUD, search, TOTP, server-side use, credential requests, OAuth connections, Connect Links
/extension — browser extension connect (headless / Puppeteer)

Run locally (development)

bun run src/index.ts

Environment: ANIMA_API_URL (defaults to a local dev API at http://127.0.0.1:3100; the production deployment sets it to the live API), MCP_BASE_URL, PORT.

Deploy production (`mcp.useanima.sh`)

Preferred path is GitHub Actions: run Deploy MCP Server (.github/workflows/deploy.yml) via workflow_dispatch.

Required repository secrets (for Workload Identity Federation / OIDC):

GCP_WORKLOAD_IDENTITY_PROVIDER (format: projects/<number>/locations/global/workloadIdentityPools/<pool>/providers/<provider>)
GCP_SERVICE_ACCOUNT_EMAIL (deployer service account in anima-labs)

Workflow behavior:

Builds and pushes us-central1-docker.pkg.dev/anima-labs/anima/mcp-server:<tag>
Deploys Cloud Run service mcp-server in us-central1
Prints GET /health response so you can confirm startedAt changed

Manual fallback (same image/deploy settings) remains:

./deploy.sh <tag>

History

Replaces five separate packages (mcp-agent, mcp-email, mcp-phone, mcp-platform, mcp-vault) and the mcp-core shared library.

Anima

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Anima?

Does Anima need an API key?

What transport does Anima use?

When was Anima last checked?

Documentation

@anima-labs/mcp-server

Endpoints

Run locally (development)

Deploy production (`mcp.useanima.sh`)

History

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Anima?

Does Anima need an API key?

What transport does Anima use?

When was Anima last checked?

Documentation

@anima-labs/mcp-server

Endpoints

Run locally (development)

Deploy production (mcp.useanima.sh)

History

Deploy production (`mcp.useanima.sh`)