Animica

io.github.animicaorgPublished by GitHub account animicaorgv0.2.2Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinance Data & Analytics AI & ML

Server details

Identifier: io.github.animicaorg/animica
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account animicaorg for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.animicaorg%2Fanimica.svg)](https://sourceweft.com/mcp/io.github.animicaorg%2Fanimica?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Animica gives an assistant read-only Animica blockchain lookups, free OpenAI-compatible AI inference, quantum randomness draws, and mining-pool stats.

What you can do: Ask Animica's AI models questions and list available models, plus check AI job status
Read chain head, blocks, and account balance/nonce (read-only, no signing)
Fetch the latest quantum randomness beacon round and compute verifiable draws (lottery, shuffle, range, dice, bytes)
Verify quantum draws and qDNA gene seals offline as pure local compute
Check mining-pool stats and network hashrate
Estimate Animica Studio run costs and list deployed Studio functions
When to use it: Useful when you want an assistant to inspect Animica chain data, query a free OpenAI-compatible model, produce or verify provably fair random draws, or check mining and Studio information without handling keys or funds.
Requirements: Runs as a local process via uvx animica-mcp or pip install animica-mcp (Python), or as a remote streamable-HTTP endpoint. Works with zero configuration against public Animica endpoints; optional environment variables set the inference base URL, RPC URL, pool URL, beacon URL, default model, timeout, and transport. ANIMICA_API_KEY is optional for higher AI rate limits.

Before you install

The server is documented as read-only and key-free: it does not sign, spend, or mutate wallet state, and chain calls are limited to an allow-list of read-only methods. Requests go to third-party Animica infrastructure (inference, RPC, pool, beacon), so prompts and lookups leave your machine. ANIMICA_API_KEY is a secret and should be supplied only through the environment.

Installation

In SourceWeft

Open Animica in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.animicaorg%2Fanimica/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

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

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 Desktop

Add to claude_desktop_config.json:

Cursor

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

VS Code

Add to .vscode/mcp.json:

json

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

{  "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

Source: README.md at commit ad4414b

Tools

SourceWeft has not read this server's tools yet.

Version history

v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declaredRequired10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts