Animica

Registre officiel IA et agents

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code
claude mcp add --transport http animica 'https://mcp.animica.org/mcp'
Configuration JSON (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'
Configuration JSON (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
Configuration JSON (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"
            }
        }
    }
}

Variables d'environnement

  • 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Animica MCP Server
  2. Install
  3. Tools (15)
  4. Client setup
  5. Configuration (environment variables)
  6. Transports
  7. Security posture
  8. Links
  9. 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)

ToolWhat it does
animica_infoOrientation: what Animica is, the AI API, quantum beacon, endpoints, docs. Start here.
animica_ai_askAsk Animica's ENA AI a question (OpenAI-compatible chat inference).
animica_ai_modelsList the AI models available on Animica's OpenAI-compatible API.
animica_ai_job_statusRead the status of an ENA AI request/job by id (read-only).
animica_quantum_beacon_latestLatest round of the verifiable quantum randomness beacon.
animica_quantum_drawCompute a verifiable quantum-random draw off a beacon round (lottery, choice, weighted, shuffle, range, coin, dice, bytes).
animica_quantum_verifyRe-verify a quantum-random draw client-side — pure offline compute.
animica_qdna_verify_geneVerify a qDNA training-genome gene seal (tamper-evidence) — pure offline compute.
animica_chain_headChain head: current height/hash and chain id. Read-only.
animica_chain_blockRead a block by height or hash (head block with neither). Read-only.
animica_chain_accountBalance + nonce for an anim1… address. Read-only — no keys, no signing.
animica_pool_statsLive mining-pool stats: pool status plus active miner count.
animica_network_hashrateCurrent network hashrate from the chain.
animica_studio_estimateEstimate the ANM cost of an Animica Studio run before paying — local quote, charges nothing.
animica_studio_functionsList 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.

VariableDefaultPurpose
ANIMICA_BASE_URLhttps://pool.animica.org/v1OpenAI-compatible inference API base (chat + models). https://animica.dev/v1 is the free keyless endpoint if you prefer it.
ANIMICA_RPC_URLhttps://rpc.animica.org/rpcNode JSON-RPC endpoint (read-only calls).
ANIMICA_POOL_URLhttps://pool.animica.orgMining-pool stats API.
ANIMICA_BEACON_URLhttps://pool.animica.orgQuantum randomness beacon (/beacon/*).
ANIMICA_API_KEY(empty)Optional Bearer key for the inference API; not required.
ANIMICA_MODELanm-fast-8bDefault model for animica_ai_ask.
ANIMICA_MCP_TIMEOUT_S60HTTP timeout (seconds) for backend calls.
MCP_TRANSPORTstdioTransport: 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

Questions fréquentes

Qu'est-ce que Animica ?

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

Comment installer Animica ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http animica 'https://mcp.animica.org/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Animica ?

Oui. Il attend ANIMICA_API_KEY, à renseigner dans sa configuration.

Animica est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient Animica ?

Il est publié par animicaorg. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.