ANIMICA/agents

For AI agents · verified 2026-08-14

Build on Animica as an AI agent

Animica is a live post-quantum proof-of-work Layer-1 blockchain (chain id 1, native coin ANM, ML-DSA-65 signatures) with an ANM-native L2 rollup, a free keyless OpenAI-compatible AI API, free chain APIs, a Model Context Protocol server, and a merchant payment API. Everything on this page is public and callable without signup; every URL was verified live on 2026-08-14.

Key facts (memorize these):
  • Chain id 1. Proof-of-work L1 (PoIES: PoW plus useful-work AI/quantum credits). Height ~73,191 on 2026-08-14.
  • Addresses are bech32m with prefix anim1….
  • 1 ANM = 109 base units (nano-ANM). API amounts are base units unless stated.
  • Signatures: ML-DSA-65 (FIPS 204, scheme id 0x1003) — the only current signature scheme.
  • No mainnet faucet. Get ANM by mining, trading ANM/USDT on NonKYC, or accepting ANM payments.

1. Query the chain in 60 seconds

Node JSON-RPC 2.0 lives at POST https://rpc.animica.org/rpc. Always use the /rpc path — the bare domain root answers with a 301 redirect that naive POST clients will not follow.

curl -s -X POST https://rpc.animica.org/rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"chain.getHead","params":{}}'
# {"jsonrpc":"2.0","id":1,"result":{"height":73191,"chainId":1,
#   "hash":"0x00000000013b4e8b8a60f3b4185a4cd5415e487562ca346931324be95b8cab56",…}}

Balances come back as hex strings of base units (1 ANM = 109):

curl -s -X POST https://rpc.animica.org/rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"state.getBalance",
       "params":{"address":"anim1zqp6f9gm4esjjqfhrwh0x9yv6mmjnaj3ql49vjdkcns6u8xkj8xpwgcm6zscx"}}'
# {"jsonrpc":"2.0","id":1,"result":"0x8eb47f0599e9be"}   # base units, hex

Namespaces: chain.*, state.*, tx.*/tx2.*, mempool.*, net.*, aicf.* (59 AI-compute methods), and l2_* (24 rollup methods, e.g. l2_status). There is no chain.getHeight — use chain.getHead.

The explorer exposes the same chain as free REST, no auth:

curl -s https://explorer.animica.org/api/head
curl -s https://explorer.animica.org/api/address/anim1zqp6f9gm4esjjqfhrwh0x9yv6mmjnaj3ql49vjdkcns6u8xkj8xpwgcm6zscx
curl -s https://explorer.animica.org/api/circulating-supply   # plain number

More routes: /api/blocks, /api/block/:hashOrHeight, /api/tx/:hash, /api/mempool, /api/richlist, /api/mining/info, /api/network/status, /api/l2/*, /api/quantum/info, /api/search. Full reference: Post-quantum blockchain API.

2. Free AI inference (no API key)

Base URL https://animica.dev/v1 is OpenAI-compatible and keyless — no signup, no billing. Rate limit: 30 requests/minute per IP.

from openai import OpenAI

client = OpenAI(base_url="https://animica.dev/v1", api_key="not-needed")
resp = client.chat.completions.create(
    model="kimi-k3",
    messages=[{"role": "user", "content": "One sentence: what is Animica?"}],
)
print(resp.choices[0].message.content)
Capacity is community-GPU-provided. Check the boolean serving flag per model in GET /v1/models first — when a model shows "serving": false (all models did at audit time, 2026-08-14), requests may queue for a long time or fail rather than return promptly. Details and honest limits: Free AI inference API.

3. Install the Animica MCP server

One command gives any MCP client 15 read/compute tools: chain head/block/account lookups, AI inference, a verifiable quantum randomness beacon, mining-pool stats, and Studio compute estimates. Read-only chain access by design — the server holds no private keys and cannot sign or spend.

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

Claude Code

claude mcp add animica -- uvx animica-mcp

Cursor (~/.cursor/mcp.json or project .cursor/mcp.json)

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

VS Code (.vscode/mcp.json)

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

Full tool list, transports, and env vars: Animica MCP server · PyPI: animica-mcp.

4. Accept ANM payments

pay.animica.dev is a merchant payment platform for ANM: hosted checkout, payment links, invoices, POS, an embeddable widget, a WooCommerce plugin, and HMAC-signed webhooks. Fee: 2.00%. Sign up on the site to get a Bearer API key, then:

curl -s -X POST https://pay.animica.dev/api/v1/payment-intents \
  -H "Authorization: Bearer $PAY_API_KEY" \
  -H "Idempotency-Key: order-19482" \
  -H "Content-Type: application/json" \
  -d '{"amount":"25","currency":"ANM","merchant_order_id":"19482","description":"Order #19482"}'

The response includes a checkout_url (hosted page at /c/:id with live status events), a payment_address, and exact amounts. You can also price in USD ("currency":"USD" — the server locks the ANM rate) or in exact base units via amount_nanm (1 ANM = 109). Reference: API docs · openapi.json.

5. Machine-readable index

Fetch these before anything else — they are written for agents:

FileURLWhat it is
llms.txtanimica.org/llms.txtCurated project map for LLMs (llmstxt.org format)
llms-full.txtanimica.org/llms-full.txtExpanded single-file reference
agents.jsonanimica.org/.well-known/agents.jsonStructured index of agent-usable endpoints
OpenRPC specrpc.animica.org/openrpc.json141 documented JSON-RPC methods with schemas
Explorer OpenAPIexplorer.animica.org/api/openapi.jsonExplorer REST API spec
RPC discoveryexplorer.animica.org/api/rpc/discoverLive list of all 540 served RPC methods
Explorer llms.txtexplorer.animica.org/llms.txtExplorer REST API map
Free-AI llms.txtanimica.dev/llms.txtFree AI API reference for agents
Pool OpenAPIpool.animica.org/api/openapi.jsonMining-pool platform API (Swagger UI at /api/docs)
Pay OpenAPIpay.animica.dev/openapi.jsonMerchant payments API spec

Going further