Animica

Read-only Animica chain data, free AI inference, verifiable quantum randomness, and mining stats.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)

Claude Code

claude mcp add --transport http animica 'https://mcp.animica.org/mcp'

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "animica": {
            "type": "http",
            "url": "https://mcp.animica.org/mcp"
        }
    }
}

Remote (streamable-http)

Claude Code

claude mcp add --transport http animica 'https://animica.dev/mcp'

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "animica": {
            "type": "http",
            "url": "https://animica.dev/mcp"
        }
    }
}

PYPI package animica-mcp

Claude Code

claude mcp add animica -e 'ANIMICA_API_KEY=<your animica_api_key>' -e 'ANIMICA_RPC_URL=https://rpc.animica.org/rpc' -e 'ANIMICA_BASE_URL=https://pool.animica.org/v1' -e 'ANIMICA_POOL_URL=https://pool.animica.org' -e 'ANIMICA_BEACON_URL=https://pool.animica.org' -e 'ANIMICA_MODEL=anm-fast-8b' -e 'ANIMICA_MCP_TIMEOUT_S=60' -- uvx animica-mcp==0.2.0

JSON configuration (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "animica": {
            "command": "uvx",
            "args": [
                "animica-mcp==0.2.0"
            ],
            "env": {
                "ANIMICA_API_KEY": "<your animica_api_key>",
                "ANIMICA_RPC_URL": "https://rpc.animica.org/rpc",
                "ANIMICA_BASE_URL": "https://pool.animica.org/v1",
                "ANIMICA_POOL_URL": "https://pool.animica.org",
                "ANIMICA_BEACON_URL": "https://pool.animica.org",
                "ANIMICA_MODEL": "anm-fast-8b",
                "ANIMICA_MCP_TIMEOUT_S": "60"
            }
        }
    }
}

Environment variables

ANIMICA_API_KEY secret Optional Animica API key (anm_live_...) for higher AI rate limits. The server works without it.
ANIMICA_RPC_URL Animica node JSON-RPC endpoint (read-only allow-listed methods only).
ANIMICA_BASE_URL OpenAI-compatible /v1 base URL used for AI inference (chat + models). https://animica.dev/v1 is the free keyless endpoint.
ANIMICA_POOL_URL Mining-pool stats API base URL.
ANIMICA_BEACON_URL Quantum randomness beacon base URL (/beacon/* endpoints).
ANIMICA_MODEL Default model id for the animica_ai_ask tool.
ANIMICA_MCP_TIMEOUT_S HTTP timeout in seconds for backend calls.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

Animica MCP Server
Install
Tools (15)
Client setup
Configuration (environment variables)
Transports
Security posture
Links
License

Animica MCP Server

Registry & packaging mirror. The server source lives in the monorepo: https://github.com/animicaorg/all/tree/main/python/animica/mcp — it ships inside the animica PyPI wheel (animica.mcp.server, [mcp] extra). This repo holds the registry/packaging metadata (server.json, Smithery/Docker files) and contains zero server code, so it can never drift from the shipped implementation.

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.

The installable package is animica-mcp — a thin console wrapper around animica[mcp]; installing it pulls in the server and exposes the animica-mcp command.

Install

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

Tools (15)

Tool	What it does
`animica_info`	Orientation: what Animica is, the AI API, quantum beacon, endpoints, docs. Start here.
`animica_ai_ask`	Ask Animica's ENA AI a question (OpenAI-compatible chat inference).
`animica_ai_models`	List the AI models available on Animica's OpenAI-compatible API.
`animica_ai_job_status`	Read the status of an ENA AI request/job by id (read-only).
`animica_quantum_beacon_latest`	Latest round of the verifiable quantum randomness beacon.
`animica_quantum_draw`	Compute a verifiable quantum-random draw off a beacon round (lottery, choice, weighted, shuffle, range, coin, dice, bytes).
`animica_quantum_verify`	Re-verify a quantum-random draw client-side — pure offline compute.
`animica_qdna_verify_gene`	Verify a qDNA training-genome gene seal (tamper-evidence) — pure offline compute.
`animica_chain_head`	Chain head: current height/hash and chain id. Read-only.
`animica_chain_block`	Read a block by height or hash (head block with neither). Read-only.
`animica_chain_account`	Balance + nonce for an `anim1…` address. Read-only — no keys, no signing.
`animica_pool_stats`	Live mining-pool stats: pool status plus active miner count.
`animica_network_hashrate`	Current network hashrate from the chain.
`animica_studio_estimate`	Estimate the ANM cost of an Animica Studio run before paying — local quote, charges nothing.
`animica_studio_functions`	List functions deployed to Animica Studio. Read-only.

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.

Variable	Default	Purpose
`ANIMICA_BASE_URL`	`https://pool.animica.org/v1`	OpenAI-compatible inference API base (chat + models). `https://animica.dev/v1` is the free keyless endpoint if you prefer it.
`ANIMICA_RPC_URL`	`https://rpc.animica.org/rpc`	Node JSON-RPC endpoint (read-only calls).
`ANIMICA_POOL_URL`	`https://pool.animica.org`	Mining-pool stats API.
`ANIMICA_BEACON_URL`	`https://pool.animica.org`	Quantum randomness beacon (`/beacon/*`).
`ANIMICA_API_KEY`	(empty)	Optional Bearer key for the inference API; not required.
`ANIMICA_MODEL`	`anm-fast-8b`	Default model for `animica_ai_ask`.
`ANIMICA_MCP_TIMEOUT_S`	`60`	HTTP timeout (seconds) for backend calls.
`MCP_TRANSPORT`	`stdio`	Transport: `stdio` (default), `streamable-http`, or `sse`.

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 (serves MCP at /mcp).
sse — MCP_TRANSPORT=sse animica-mcp (legacy SSE clients).

The Dockerfile + smithery.yaml in this repo package the streamable-HTTP mode for Smithery and other container hosts (listens on $PORT, serves MCP at /mcp).

Security posture

Read + compute only. Chain access goes through a hard-coded allow-list of read-only JSON-RPC methods (RPC_READ_ALLOWLIST in the source); 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.

License

Apache-2.0

Frequently asked questions

What is Animica?

Read-only Animica chain data, free AI inference, verifiable quantum randomness, and mining stats.

How do I install Animica?

It runs as a remote server. In Claude Code: claude mcp add --transport http animica 'https://mcp.animica.org/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Animica need an API key?

Yes. It expects ANIMICA_API_KEY, which you set in its configuration.

Is Animica open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains Animica?

It is published by animicaorg. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: animicaorg
Category: AI and agents
Runs: Remote + Local
GitHub stars: ★ 0
License: Apache-2.0
Language: Dockerfile
Last commit: Aug 14, 2026
Open issues: 0
Version: 0.2.2
Published: Aug 14, 2026

io.github.animicaorg/animica

Similar servers

GhostPaw Codex Local belief and memory engine with evidence, certainty, and honest revision history.
Port OS Smart Home Connect AI to smart home devices: discover, read state and control with approved permis...
Zono Support Work your Zono Support help desk from an AI client: tickets, customers, purchases and k...
Airlox End-to-end encrypted sessions where agents share messages, files and runnable Python.
Agent Data Broker Company enrichment + SEC EDGAR filings, financials, insider trades for agents; $0.01 US...
Replai Set up, test and publish an AI customer support Agent for your SaaS product.
Remote Desktop Commander Remote Desktop Commander: use files, terminal and processes on your own computers from ...
DFM · The Fund Management OS Launch, deposit into, rebalance and redeem onchain funds on Solana mainnet.

AI and agents