animica-mcp

MCP (Model Context Protocol) server for the Animica AI + blockchain network. One command gives any MCP client (Claude Code, Claude Desktop, Cursor, VS Code, …) 15 read/compute tools: OpenAI-compatible AI inference, a verifiable quantum randomness beacon, read-only chain and account lookups, mining-pool stats, and Studio compute cost estimates.

This package is a thin console wrapper around animica[mcp] — the server implementation lives in the animica package (animica.mcp.server); installing animica-mcp pulls it in and exposes the animica-mcp command.

Install

pip install animica-mcp
# or run it without installing:
uvx animica-mcp

Tools (15)

Client setup

Claude Code

claude mcp add animica -- uvx animica-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "animica": {
      "command": "uvx",
      "args": ["animica-mcp"]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (or project .cursor/mcp.json):

{
  "mcpServers": {
    "animica": {
      "command": "uvx",
      "args": ["animica-mcp"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "animica": {
      "type": "stdio",
      "command": "uvx",
      "args": ["animica-mcp"]
    }
  }
}

If you installed with pip install animica-mcp, replace "command": "uvx", "args": ["animica-mcp"] with "command": "animica-mcp" in any of the configs above.

Configuration (environment variables)

All endpoints default to public Animica infrastructure — the server works with zero configuration.

Transports

• stdio (default) — what Claude Code / Claude Desktop / Cursor / VS Code use; just run animica-mcp.
• streamable-http — MCP_TRANSPORT=streamable-http animica-mcp serves HTTP on 127.0.0.1:8765. For host/port flags use the full CLI from the animica package: animica mcp serve --transport http --host 0.0.0.0 --port 8765.
• sse — MCP_TRANSPORT=sse animica-mcp (legacy SSE clients).

Security posture

• Read + compute only. Chain access goes through a hard-coded allow-list of read-only JSON-RPC methods; mutating methods (send, sign, deploy, claim) are not on the list and cannot be reached, even by a bug.
• No keys. The server never handles private keys, never signs, never spends, and never mutates wallet state.
• Quantum draw/verify and qDNA gene verification are pure local compute and work fully offline.

Links

• Homepage: https://animica.dev (free OpenAI-compatible AI API at https://animica.dev/v1)
• Developer docs: https://animica.org/developers
• Explorer: https://explorer.animica.org
• Mining pool: https://pool.animica.org
• Monorepo: https://github.com/animicaorg/all
• Core package: https://pypi.org/project/animica/
• Contact: ai@3vdc.com

License

Apache-2.0