Animica

Official22 toolsLive

by animicaorg · Dockerfile

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

io.github.animicaorg/animica — MCP Server

This Model Context Protocol (MCP) server exposes read-only Animica chain data and associated mining stats. It also provides free AI inference and verifiable quantum randomness. The server is packaged for use via the animica PyPI wheel, including the animica.mcp.server component with the [mcp] extra.

🛠️ Key Features

Read-only Animica chain data access
Free AI inference capability
Verifiable quantum randomness
Mining statistics exposure
Tool count: 22

🚀 Use Cases

Building MCP clients that query Animica chain data
Incorporating verifiable quantum randomness into applications
Using mining stats for monitoring or analytics
Integrating with LLM workflows via MCP

⚡ Developer Benefits

Conforms to MCP (Model Context Protocol)
Ships as animica.mcp.server in the animica PyPI wheel with [mcp]
Topics include JSON-RPC and openai-compatible integration

⚠️ Limitations

Described as read-only with respect to the Animica chain data
No additional behavioral details beyond the provided excerpt

Topics

ai-agentsanimicablockchainclaudecryptocurrencycursorjson-rpcllmmcpmcp-servermodel-context-protocolopenai-compatiblepost-quantum-cryptographypythonuvx

Captured live from the server via tools/list.

animica_info

What Animica is and how to use it: the OpenAI-compatible AI API, the

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "animica_infoArguments"
}

animica_ai_ask

Ask Animica's ENA AI a question (OpenAI-compatible inference). Cheap general

Parameters5

prompt	string	required
model	string	optional
max_tokens	integer	optional
temperature	number	optional
system	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "title": "Prompt",
      "type": "string"
    },
    "model": {
      "default": "",
      "title": "Model",
      "type": "string"
    },
    "max_tokens": {
      "default": 1024,
      "title": "Max Tokens",
      "type": "integer"
    },
    "temperature": {
      "default": 0.4,
      "title": "Temperature",
      "type": "number"
    },
    "system": {
      "default": "",
      "title": "System",
      "type": "string"
    }
  },
  "required": [
    "prompt"
  ],
  "title": "animica_ai_askArguments"
}

animica_ai_models

List the AI models available on Animica's OpenAI-compatible API.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "animica_ai_modelsArguments"
}

animica_ai_job_status

Read the status of an ENA AI request/job by id (read-only). Returns the

Parameters1

job_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "title": "Job Id",
      "type": "string"
    }
  },
  "required": [
    "job_id"
  ],
  "title": "animica_ai_job_statusArguments"
}

animica_quantum_beacon_latest

Get the latest round of Animica's verifiable quantum randomness beacon

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "animica_quantum_beacon_latestArguments"
}

animica_quantum_draw

Compute a verifiable quantum-random draw off a beacon round.

Parameters5

kind	string	required
request_id	string	required
params_json	string	optional
round_id	integer	optional
beacon_hex	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "kind": {
      "title": "Kind",
      "type": "string"
    },
    "request_id": {
      "title": "Request Id",
      "type": "string"
    },
    "params_json": {
      "default": "{}",
      "title": "Params Json",
      "type": "string"
    },
    "round_id": {
      "default": -1,
      "title": "Round Id",
      "type": "integer"
    },
    "beacon_hex": {
      "default": "",
      "title": "Beacon Hex",
      "type": "string"
    }
  },
  "required": [
    "kind",
    "request_id"
  ],
  "title": "animica_quantum_drawArguments"
}

animica_quantum_verify

Verify a quantum-random draw client-side: recompute it from its declared

Parameters1

result_json

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "result_json": {
      "title": "Result Json",
      "type": "string"
    }
  },
  "required": [
    "result_json"
  ],
  "title": "animica_quantum_verifyArguments"
}

animica_qdna_verify_gene

Verify a qDNA training-genome gene seal: recompute its content-address

Parameters1

gene_json

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "gene_json": {
      "title": "Gene Json",
      "type": "string"
    }
  },
  "required": [
    "gene_json"
  ],
  "title": "animica_qdna_verify_geneArguments"
}

animica_chain_head

Read the chain head: current height/hash and chain id. Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "animica_chain_headArguments"
}

animica_chain_block

Read a block by ``height`` or by ``hash`` (read-only). With neither, reads

Parameters2

height	integer	optional
hash	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "height": {
      "default": -1,
      "title": "Height",
      "type": "integer"
    },
    "hash": {
      "default": "",
      "title": "Hash",
      "type": "string"
    }
  },
  "title": "animica_chain_blockArguments"
}

animica_chain_account

READ-ONLY account snapshot for an ``anim1...`` address: balance + nonce.

Parameters1

address

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "title": "Address",
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "title": "animica_chain_accountArguments"
}

animica_pool_stats

Live mining-pool stats: pool status plus active miner count. Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "animica_pool_statsArguments"
}

animica_network_hashrate

Read the current network hashrate from the chain. Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "animica_network_hashrateArguments"
}

animica_studio_estimate

Estimate the ANM cost of an Animica Studio run BEFORE paying

Parameters3

seconds	number	optional
gpu	boolean	optional
mem_gb	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "seconds": {
      "default": 15,
      "title": "Seconds",
      "type": "number"
    },
    "gpu": {
      "default": false,
      "title": "Gpu",
      "type": "boolean"
    },
    "mem_gb": {
      "default": 0.5,
      "title": "Mem Gb",
      "type": "number"
    }
  },
  "title": "animica_studio_estimateArguments"
}

animica_studio_functions

List functions deployed to Animica Studio (aicf.fn.list). Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "animica_studio_functionsArguments"
}

animica_x402_products

Discover Animica's pay-per-request x402 APIs (USDC on Base): price, availability.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "animica_x402_productsArguments"
}

animica_web_fetch

PAID (~$0.005, or free with a credit token): fetch a public web page as clean text.

Parameters3

url	string	required
credits	string	optional
max_chars	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "title": "Url",
      "type": "string"
    },
    "credits": {
      "default": "",
      "title": "Credits",
      "type": "string"
    },
    "max_chars": {
      "default": 0,
      "title": "Max Chars",
      "type": "integer"
    }
  },
  "required": [
    "url"
  ],
  "title": "animica_web_fetchArguments"
}

animica_web_ask

PAID (~$0.007): answer a question about ONE web page, WITH its sources.

Parameters3

url	string	required
question	string	required
credits	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "title": "Url",
      "type": "string"
    },
    "question": {
      "title": "Question",
      "type": "string"
    },
    "credits": {
      "default": "",
      "title": "Credits",
      "type": "string"
    }
  },
  "required": [
    "url",
    "question"
  ],
  "title": "animica_web_askArguments"
}

animica_embed

PAID (~$0.005 per BATCH): embed up to 256 texts in one call (384-dim).

Parameters2

texts_json	string	required
credits	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "texts_json": {
      "title": "Texts Json",
      "type": "string"
    },
    "credits": {
      "default": "",
      "title": "Credits",
      "type": "string"
    }
  },
  "required": [
    "texts_json"
  ],
  "title": "animica_embedArguments"
}

animica_notarize

PAID (~$0.006): anchor a SHA-256 digest on-chain with a verifiable proof.

Parameters3

digest	string	required
memo	string	optional
credits	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "digest": {
      "title": "Digest",
      "type": "string"
    },
    "memo": {
      "default": "",
      "title": "Memo",
      "type": "string"
    },
    "credits": {
      "default": "",
      "title": "Credits",
      "type": "string"
    }
  },
  "required": [
    "digest"
  ],
  "title": "animica_notarizeArguments"
}

animica_pq_verify

PAID (~$0.005): verify a post-quantum signature (ML-DSA-65 / Dilithium3 / SPHINCS+).

Parameters5

alg_id	integer	required
message_hex	string	required
signature_hex	string	required
public_key_hex	string	required
credits	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "alg_id": {
      "title": "Alg Id",
      "type": "integer"
    },
    "message_hex": {
      "title": "Message Hex",
      "type": "string"
    },
    "signature_hex": {
      "title": "Signature Hex",
      "type": "string"
    },
    "public_key_hex": {
      "title": "Public Key Hex",
      "type": "string"
    },
    "credits": {
      "default": "",
      "title": "Credits",
      "type": "string"
    }
  },
  "required": [
    "alg_id",
    "message_hex",
    "signature_hex",
    "public_key_hex"
  ],
  "title": "animica_pq_verifyArguments"
}

animica_credit_balance

FREE: balance, expiry and spend history for a prepaid credit token.

Parameters1

credits

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "credits": {
      "default": "",
      "title": "Credits",
      "type": "string"
    }
  },
  "title": "animica_credit_balanceArguments"
}

README.md6 KBView on GitHub

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

bash

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

bash

claude mcp add animica -- uvx animica-mcp

Claude Desktop

Add to claude_desktop_config.json:

json

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

Cursor

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

json

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

VS Code

Add to .vscode/mcp.json:

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

Install

Tools (22)

animica_infoanimica_ai_askanimica_ai_modelsanimica_ai_job_statusanimica_quantum_beacon_latestanimica_quantum_drawanimica_quantum_verifyanimica_qdna_verify_gene

Configuration

Environment variables

ANIMICA_API_KEYsecret

Optional Animica API key (anm_live_...) for higher AI rate limits. The server works without it.

ANIMICA_RPC_URLdefault https://rpc.animica.org/rpc

Animica node JSON-RPC endpoint (read-only allow-listed methods only).

ANIMICA_BASE_URLdefault https://pool.animica.org/v1

OpenAI-compatible /v1 base URL used for AI inference (chat + models). https://animica.dev/v1 is the free keyless endpoint.

ANIMICA_POOL_URLdefault https://pool.animica.org

Mining-pool stats API base URL.

ANIMICA_BEACON_URLdefault https://pool.animica.org

Quantum randomness beacon base URL (/beacon/* endpoints).

ANIMICA_MODELdefault anm-fast-8b

Default model id for the animica_ai_ask tool.

ANIMICA_MCP_TIMEOUT_Sdefault 60

HTTP timeout in seconds for backend calls.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "animica": {
      "command": "uvx",
      "args": [
        "animica-mcp"
      ],
      "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"
      }
    }
  }
}

io.github.animicaorg/animica — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

animica_info

animica_ai_ask

animica_ai_models

animica_ai_job_status

animica_quantum_beacon_latest

animica_quantum_draw

animica_quantum_verify

animica_qdna_verify_gene

animica_chain_head

animica_chain_block

animica_chain_account

animica_pool_stats

animica_network_hashrate

animica_studio_estimate

animica_studio_functions

animica_x402_products

animica_web_fetch

animica_web_ask

animica_embed

animica_notarize

animica_pq_verify

animica_credit_balance

Animica MCP Server

Install

Tools (15)

Client setup

Claude Code

Claude Desktop

Cursor

VS Code

Configuration (environment variables)

Transports

Security posture

Links

License

Install

Configuration

Related servers