Animica MCP Server

Name: Animica MCP Server
Author: org.animica

org.animica/animica

Repository Registry

What is the Animica MCP server?

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

How to install Animica

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "animica": {
      "command": "uvx",
      "args": [
        "animica-mcp"
      ],
      "env": {
        "ANIMICA_API_KEY": "<YOUR_ANIMICA_API_KEY>",
        "ANIMICA_RPC_URL": "<YOUR_ANIMICA_RPC_URL>",
        "ANIMICA_BASE_URL": "<YOUR_ANIMICA_BASE_URL>",
        "ANIMICA_POOL_URL": "<YOUR_ANIMICA_POOL_URL>",
        "ANIMICA_BEACON_URL": "<YOUR_ANIMICA_BEACON_URL>",
        "ANIMICA_MODEL": "<YOUR_ANIMICA_MODEL>",
        "ANIMICA_MCP_TIMEOUT_S": "<YOUR_ANIMICA_MCP_TIMEOUT_S>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "animica": {
      "command": "uvx",
      "args": [
        "animica-mcp"
      ],
      "env": {
        "ANIMICA_API_KEY": "<YOUR_ANIMICA_API_KEY>",
        "ANIMICA_RPC_URL": "<YOUR_ANIMICA_RPC_URL>",
        "ANIMICA_BASE_URL": "<YOUR_ANIMICA_BASE_URL>",
        "ANIMICA_POOL_URL": "<YOUR_ANIMICA_POOL_URL>",
        "ANIMICA_BEACON_URL": "<YOUR_ANIMICA_BEACON_URL>",
        "ANIMICA_MODEL": "<YOUR_ANIMICA_MODEL>",
        "ANIMICA_MCP_TIMEOUT_S": "<YOUR_ANIMICA_MCP_TIMEOUT_S>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "animica": {
      "command": "uvx",
      "args": [
        "animica-mcp"
      ],
      "env": {
        "ANIMICA_API_KEY": "<YOUR_ANIMICA_API_KEY>",
        "ANIMICA_RPC_URL": "<YOUR_ANIMICA_RPC_URL>",
        "ANIMICA_BASE_URL": "<YOUR_ANIMICA_BASE_URL>",
        "ANIMICA_POOL_URL": "<YOUR_ANIMICA_POOL_URL>",
        "ANIMICA_BEACON_URL": "<YOUR_ANIMICA_BEACON_URL>",
        "ANIMICA_MODEL": "<YOUR_ANIMICA_MODEL>",
        "ANIMICA_MCP_TIMEOUT_S": "<YOUR_ANIMICA_MCP_TIMEOUT_S>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "animica": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "animica-mcp"
      ],
      "env": {
        "ANIMICA_API_KEY": "<YOUR_ANIMICA_API_KEY>",
        "ANIMICA_RPC_URL": "<YOUR_ANIMICA_RPC_URL>",
        "ANIMICA_BASE_URL": "<YOUR_ANIMICA_BASE_URL>",
        "ANIMICA_POOL_URL": "<YOUR_ANIMICA_POOL_URL>",
        "ANIMICA_BEACON_URL": "<YOUR_ANIMICA_BEACON_URL>",
        "ANIMICA_MODEL": "<YOUR_ANIMICA_MODEL>",
        "ANIMICA_MCP_TIMEOUT_S": "<YOUR_ANIMICA_MCP_TIMEOUT_S>"
      }
    }
  }
}

Claude Code

claude mcp add animica --env ANIMICA_API_KEY=<YOUR_ANIMICA_API_KEY> --env ANIMICA_RPC_URL=<YOUR_ANIMICA_RPC_URL> --env ANIMICA_BASE_URL=<YOUR_ANIMICA_BASE_URL> --env ANIMICA_POOL_URL=<YOUR_ANIMICA_POOL_URL> --env ANIMICA_BEACON_URL=<YOUR_ANIMICA_BEACON_URL> --env ANIMICA_MODEL=<YOUR_ANIMICA_MODEL> --env ANIMICA_MCP_TIMEOUT_S=<YOUR_ANIMICA_MCP_TIMEOUT_S> -- uvx animica-mcp