ANIMICA.DEV/agents

For AI agents · verified 2026-08-14

Use Animica as an AI agent — free AI first

animica.dev runs a free, keyless, OpenAI-compatible AI API at https://animica.dev/v1 — no API key, no signup, no billing. Behind it sits the Animica post-quantum blockchain (chain id 1, coin ANM), whose chain APIs, MCP server, and payment rails are equally open to agents. Every URL here was verified live on 2026-08-14.

1. Free AI inference in 60 seconds

Any OpenAI client works — point base_url at https://animica.dev/v1 and pass any non-empty string as the key:

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": "Say hello in five words."}],
)
print(resp.choices[0].message.content)
curl -s https://animica.dev/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"kimi-k3","messages":[{"role":"user","content":"Hello"}]}'

Streaming works too: set "stream": true for Server-Sent Events. List models with GET https://animica.dev/v1/models: kimi-k3 (default, flagship coding & chat), animica-chat, animica-chat-small, animica-chat-flagship, animica-knowledge (ENA, network-trained).

Honest limits. Rate limit 30 requests/minute per IP. Compute is provided by community GPU workers on the Animica network — each entry in /v1/models carries a boolean serving flag. When "serving": false (all models at audit time), requests may queue for a long time or fail rather than return promptly, so check the flag first and use a generous client timeout. kimi-k3 may emit <think>…</think> reasoning blocks — strip them if you need clean output. Full reference: Free AI inference API.

2. Install the Animica MCP server

15 read/compute tools for any MCP client: AI inference, chain head/block/account lookups, a verifiable quantum randomness beacon, pool stats, Studio cost estimates. Read-only chain access — no private keys, no signing, no spending.

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) / Claude Desktop (claude_desktop_config.json)

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

VS Code (.vscode/mcp.json)

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

Details: Animica MCP server · PyPI: animica-mcp.

3. Query the chain (free, no key)

JSON-RPC 2.0 at POST https://rpc.animica.org/rpc — always the /rpc path; the bare root 301-redirects and breaks naive POST clients:

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,…}}

Or REST via the explorer: https://explorer.animica.org/api/head, /api/address/:anim1…, /api/block/:hashOrHeight, /api/circulating-supply. Amounts are base units (1 ANM = 109); addresses are bech32m anim1…; signatures are ML-DSA-65 (FIPS 204). Full page: Post-quantum blockchain API.

4. Accept ANM payments

pay.animica.dev gives you hosted checkout, payment links, invoices, POS, a widget, WooCommerce, and HMAC-signed webhooks at a 2.00% fee. Sign up for 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"}'

The response carries checkout_url and payment_address. Price in USD ("currency":"USD", rate locked server-side) or exact base units via amount_nanm. Docs: pay.animica.dev/docs · openapi.json.

5. Machine-readable index

FileURLWhat it is
Free-AI llms.txtanimica.dev/llms.txtThis site's API reference for agents
Project llms.txtanimica.org/llms.txtCurated map of the whole Animica project
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
Pool OpenAPIpool.animica.org/api/openapi.jsonMining-pool platform API (Swagger at /api/docs)
Pay OpenAPIpay.animica.dev/openapi.jsonMerchant payments API spec

Going further