Animica

OpenAI-compatible AI inference, code, embeddings & agent tools for bots — and mine ANM.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Animica L1 Blockchain

Canonical repo: main of animicaorg/all is the canonical source tree. Current release: 10.1.0 (pip install animica).

Animica is a fully decentralized layer-1 blockchain platform for verifiable AI and quantum-secure execution. This repository houses the complete blockchain node implementation, consensus engine, execution layer, cryptographic infrastructure, wallets, SDKs, developer tooling, and supporting services for running and extending the network.

🌟 Key Features

Fully Decentralized P2P Network: Gossip-based peer discovery and communication with no central authority
Post-Quantum Cryptography: ML-DSA-65 (FIPS 204, the successor of Dilithium3) signatures — scheme id 0x1003, the only current signature scheme. SPHINCS+ appears in older code/docs but is legacy; do not build on it. Enumerate live schemes via the tx.getSupportedSignatureSchemes RPC.
PoIES Consensus: Proof-of-Integrated-External-Services combining hash-share work with AI/Quantum/Storage proofs
Multiple Transport Protocols: TCP, QUIC, and WebSocket with end-to-end encryption
Python-VM Execution: Deterministic Python-based smart contracts with gas metering
AI & Quantum Integration: Off-chain compute coordination via AICF (AI Capability Framework)
Multi-Network Support: Mainnet, testnet, devnet configurations with isolated state
Developer Tools: Studio IDE, contract templates, multi-language SDKs (Python, TypeScript, Rust)
Fast Sync with Snapshots: Bootstrap new nodes in minutes using pre-built chain snapshots at checkpoints

📁 Repository Structure

This monorepo contains:

Core Protocol: core/, consensus/, execution/, mempool/, rpc/, p2p/, mining/
- P2P Network (p2p/): Full peer-to-peer networking with quantum-resistant handshake, gossip protocol, and multi-transport support
- Consensus (consensus/): PoIES algorithm for decentralized block validation
Cryptography & Proofs: proofs/, zk/, pq/, randomness/
Wallets & Explorer:
- wallet-qt/ - Qt desktop wallet with embedded node (macOS/Windows/Linux)
- wallet/ - Flutter mobile wallet
- wallet-extension/ - Browser extension wallet
- explorer-web/ - Block explorer
Mining: mining/ (core), apps/miner-gui/ (Qt desktop GUI miner)
Studio & Tooling: studio-web/, studio-wasm/, studio-services/, templates/
SDKs & APIs: sdk/ (Python/TypeScript/Rust), docs/ (specifications), spec/ (canonical schemas)
Operations: ops/, tests/devnet/, installers/, chains/ (network metadata)
Website: website/ (Astro + TypeScript main site)
Compute Platform: packages/ (Auth, Billing, Inference, Sandbox, GitHub App services) - See COMPUTE_PLATFORM_QUICKSTART.md

Each module has its own README with detailed information. See the Copilot instructions at the bottom of this file for coding guidelines.

🚀 Animica Compute + LLM Cloud Platform

The Animica Compute Platform provides enterprise-ready LLM inference, code execution, and GitHub integration with native ANM token payments.

Quick Start:

bash

make compute-dev  # Start all compute services with Docker Compose

See COMPUTE_PLATFORM_QUICKSTART.md for detailed setup instructions.

🌍 Website

The production website lives in website/. See website/README.md for local dev and Docker deployment (nginx on port 4321).

🌐 Decentralized Architecture

Animica is a fully peer-to-peer network where nodes communicate directly without relying on central servers:

✅ Peer Discovery: Automatic discovery via DNS seeds, mDNS, and Kademlia DHT
✅ Gossip Protocol: Efficient block/transaction/proof propagation
✅ Consensus: Deterministic PoIES validation by all nodes
✅ No Central Authority: Public RPC nodes (e.g. https://rpc.animica.org/rpc) are convenience helpers for discovery and sync; run your own node for day-to-day queries and mining.

Run your own node to strengthen the network and maintain decentralization. See P2P Networking Guide for details.

🌐 Live Endpoints (Mainnet)

Service	Endpoint	Notes
Node JSON-RPC	`POST https://rpc.animica.org/rpc`	JSON-RPC 2.0. The `/rpc` path is required — the bare domain 301-redirects and breaks naive POST clients
Explorer REST API	`https://explorer.animica.org/api/…`	Free, no auth: `/head`, `/blocks`, `/tx/:hash`, `/address/:bech32`, `/richlist`, `/circulating-supply`, `/mining/info`, `/l2/`, `/aicf/`
Block explorer	`https://explorer.animica.org`	Web UI
Free AI inference	`https://animica.dev/v1`	OpenAI-compatible, keyless, 30 req/min/IP. Community-GPU capacity: check each model's `serving` flag in `/v1/models`
Mining pool	`stratum+tcp://pool.animica.org:3333`	PPS + sub-block shares; `:3334` = solo (95/5). Stats/Swagger: `https://pool.animica.org/api/docs`
Payments	`https://pay.animica.dev`	Merchant REST, hosted checkout, 2.00% fee, amounts in base units (1 ANM = 10^9)
PyPI	`https://pypi.org/project/animica/`	`pip install animica`

Example:

Terminal

curl -s -X POST https://rpc.animica.org/rpc -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"chain.getHead","params":{}}'

📋 Prerequisites

Required Software

Python 3.11+ with venv and pip
Node.js 20+ with npm
Docker and Docker Compose (v2.0+) for running nodes
Git for repository management

Build Tools (Optional, for Rust Components)

On Ubuntu/Debian:

bash

sudo apt-get update
sudo apt-get install -y build-essential pkg-config libssl-dev

On macOS (via Homebrew):

bash

brew install pkg-config openssl

Operating System Notes

Linux: Recommended for production (Ubuntu 22.04+ or Debian 12+)
macOS: Fully supported for development (macOS 12+)
Windows: Use WSL2 (Windows Subsystem for Linux) with Ubuntu 22.04+

🚀 Installation & Setup

🚴‍♂️ CLI Quickstart (Everything End-to-End)

Install dependencies & create the venv

bash

./setup.sh            # or: FRESH=1 ./setup.sh --fresh
source .venv/bin/activate

Pick the network profile (determines RPC/P2P ports, data dir, and seeds):

bash

animica network set devnet          # mainnet | testnet | devnet | local-devnet
animica network get                 # confirm selection

Start your node from the CLI (Docker Compose wrapper):

bash

animica node up                     # background (default)
animica node up --no-detach         # foreground with logs
animica node up --with-miner        # include miner service

Verify health and sync:

bash

animica node status                 # chain head, peers, sync info
animica node head                   # latest block header
animica peer list                   # connected peers (expect >0)
animica sync status                 # detailed sync progress

💡 Fast Sync with Snapshots:

New nodes can bootstrap much faster using chain snapshots:

server.ts

# Verify snapshot system is working
python3 scripts/verify_snapshot_system.py

# Enable snapshot sync (enabled by default)
export ANIMICA_SNAPSHOT_SYNC_ENABLED=true
export ANIMICA_SNAPSHOT_RPC_URL=http://snapshots.animica.org:8545/rpc  # Optional

# Start node - automatically downloads snapshot if available
animica node up

# Or manually download/import snapshot
animica snapshot list
animica snapshot import /path/to/snapshot

See SNAPSHOT_VERIFICATION_GUIDE.md for complete guide and troubleshooting.

Ensure peers connect (connectivity checklist):

bash

animica peer list --verbose         # shows multiaddrs + scores
docker compose -f tests/devnet/docker-compose.yml -p animica-devnet logs -f node1 | grep p2p

If peer count stays 0: verify ANIMICA_P2P_SEEDS (or use defaults), open TCP/QUIC ports on your host, and confirm you selected the right network. For a manual seed bump, set:

server.ts

export ANIMICA_P2P_SEEDS="/dns4/seed.animica.org/tcp/30333"
animica node down && animica node up

Create a wallet and fund it (dev/test only):

bash

animica wallet create --label mywallet
animica faucet request mywallet     # devnet/testnet only
animica wallet show mywallet --source chain

Send a transaction (with the running node):

bash

animica tx send --from mywallet --to anim1recipient... --value 1.0
animica tx status <tx_hash>

Stop services when done:

bash

animica node down                   # keep data
animica node down --volumes         # wipe data (irreversible)

Need a deeper walkthrough? The sections below expand on each CLI area (networking, node ops, wallets, mining, RPC, Studio Services, Docker, non-Docker boot, and troubleshooting).

💰 Animica Wallet Desktop App

For users who want a simpler "just works" experience without managing the CLI, the Animica Wallet Qt provides a cross-platform desktop application with an embedded node.

Downloads

Current Release: v0.1.0 (Coming Soon)

Platform	Download	Notes
🍎 macOS	`.dmg` installer	Universal (Apple Silicon + Intel)
🪟 Windows	`.msi` installer	Windows 10/11 (x64)
🐧 Linux	`.AppImage` or `.deb`	Universal AppImage or Debian package

Installation:

macOS: Download DMG, drag to Applications folder
Windows: Download MSI, run installer
Linux AppImage: Download, chmod +x, and run
Linux DEB: sudo dpkg -i animica-wallet_*.deb

Features

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

24d ago

Most recent push to the default branch.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Animica

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "animica": { "command": "uvx", "args": ["animica-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/animica?style=directory)](https://allmcps.com/mcp/animica)

HTML Embed

<a href="https://allmcps.com/mcp/animica"><img src="https://allmcps.com/api/badge/animica?style=directory" alt="Animica on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

10/12 checks healthy over the last 45d

41Quality signal: Fair · 41/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity5/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · animica-mcp (PyPI)

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Animica →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Animica

OpenAI-compatible AI inference, code, embeddings & agent tools for bots — and mine ANM.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Animica L1 Blockchain

Canonical repo: main of animicaorg/all is the canonical source tree. Current release: 10.1.0 (pip install animica).

🌟 Key Features

Fully Decentralized P2P Network: Gossip-based peer discovery and communication with no central authority
Post-Quantum Cryptography: ML-DSA-65 (FIPS 204, the successor of Dilithium3) signatures — scheme id 0x1003, the only current signature scheme. SPHINCS+ appears in older code/docs but is legacy; do not build on it. Enumerate live schemes via the tx.getSupportedSignatureSchemes RPC.
PoIES Consensus: Proof-of-Integrated-External-Services combining hash-share work with AI/Quantum/Storage proofs
Multiple Transport Protocols: TCP, QUIC, and WebSocket with end-to-end encryption
Python-VM Execution: Deterministic Python-based smart contracts with gas metering
AI & Quantum Integration: Off-chain compute coordination via AICF (AI Capability Framework)
Multi-Network Support: Mainnet, testnet, devnet configurations with isolated state
Developer Tools: Studio IDE, contract templates, multi-language SDKs (Python, TypeScript, Rust)
Fast Sync with Snapshots: Bootstrap new nodes in minutes using pre-built chain snapshots at checkpoints

📁 Repository Structure

This monorepo contains:

Core Protocol: core/, consensus/, execution/, mempool/, rpc/, p2p/, mining/
- P2P Network (p2p/): Full peer-to-peer networking with quantum-resistant handshake, gossip protocol, and multi-transport support
- Consensus (consensus/): PoIES algorithm for decentralized block validation
Cryptography & Proofs: proofs/, zk/, pq/, randomness/
Wallets & Explorer:
- wallet-qt/ - Qt desktop wallet with embedded node (macOS/Windows/Linux)
- wallet/ - Flutter mobile wallet
- wallet-extension/ - Browser extension wallet
- explorer-web/ - Block explorer
Mining: mining/ (core), apps/miner-gui/ (Qt desktop GUI miner)
Studio & Tooling: studio-web/, studio-wasm/, studio-services/, templates/
SDKs & APIs: sdk/ (Python/TypeScript/Rust), docs/ (specifications), spec/ (canonical schemas)
Operations: ops/, tests/devnet/, installers/, chains/ (network metadata)
Website: website/ (Astro + TypeScript main site)
Compute Platform: packages/ (Auth, Billing, Inference, Sandbox, GitHub App services) - See COMPUTE_PLATFORM_QUICKSTART.md

Each module has its own README with detailed information. See the Copilot instructions at the bottom of this file for coding guidelines.

🚀 Animica Compute + LLM Cloud Platform

The Animica Compute Platform provides enterprise-ready LLM inference, code execution, and GitHub integration with native ANM token payments.

Quick Start:

bash

make compute-dev  # Start all compute services with Docker Compose

See COMPUTE_PLATFORM_QUICKSTART.md for detailed setup instructions.

🌍 Website

The production website lives in website/. See website/README.md for local dev and Docker deployment (nginx on port 4321).

🌐 Decentralized Architecture

Animica is a fully peer-to-peer network where nodes communicate directly without relying on central servers:

✅ Peer Discovery: Automatic discovery via DNS seeds, mDNS, and Kademlia DHT
✅ Gossip Protocol: Efficient block/transaction/proof propagation
✅ Consensus: Deterministic PoIES validation by all nodes
✅ No Central Authority: Public RPC nodes (e.g. https://rpc.animica.org/rpc) are convenience helpers for discovery and sync; run your own node for day-to-day queries and mining.

Run your own node to strengthen the network and maintain decentralization. See P2P Networking Guide for details.

🌐 Live Endpoints (Mainnet)

Service	Endpoint	Notes
Node JSON-RPC	`POST https://rpc.animica.org/rpc`	JSON-RPC 2.0. The `/rpc` path is required — the bare domain 301-redirects and breaks naive POST clients
Explorer REST API	`https://explorer.animica.org/api/…`	Free, no auth: `/head`, `/blocks`, `/tx/:hash`, `/address/:bech32`, `/richlist`, `/circulating-supply`, `/mining/info`, `/l2/`, `/aicf/`
Block explorer	`https://explorer.animica.org`	Web UI
Free AI inference	`https://animica.dev/v1`	OpenAI-compatible, keyless, 30 req/min/IP. Community-GPU capacity: check each model's `serving` flag in `/v1/models`
Mining pool	`stratum+tcp://pool.animica.org:3333`	PPS + sub-block shares; `:3334` = solo (95/5). Stats/Swagger: `https://pool.animica.org/api/docs`
Payments	`https://pay.animica.dev`	Merchant REST, hosted checkout, 2.00% fee, amounts in base units (1 ANM = 10^9)
PyPI	`https://pypi.org/project/animica/`	`pip install animica`

Example:

Terminal

curl -s -X POST https://rpc.animica.org/rpc -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"chain.getHead","params":{}}'

📋 Prerequisites

Required Software

Python 3.11+ with venv and pip
Node.js 20+ with npm
Docker and Docker Compose (v2.0+) for running nodes
Git for repository management

Build Tools (Optional, for Rust Components)

On Ubuntu/Debian:

bash

sudo apt-get update
sudo apt-get install -y build-essential pkg-config libssl-dev

On macOS (via Homebrew):

bash

brew install pkg-config openssl

Operating System Notes

Linux: Recommended for production (Ubuntu 22.04+ or Debian 12+)
macOS: Fully supported for development (macOS 12+)
Windows: Use WSL2 (Windows Subsystem for Linux) with Ubuntu 22.04+

🚀 Installation & Setup

🚴‍♂️ CLI Quickstart (Everything End-to-End)

Install dependencies & create the venv

bash

./setup.sh            # or: FRESH=1 ./setup.sh --fresh
source .venv/bin/activate

Pick the network profile (determines RPC/P2P ports, data dir, and seeds):

bash

animica network set devnet          # mainnet | testnet | devnet | local-devnet
animica network get                 # confirm selection

Start your node from the CLI (Docker Compose wrapper):

bash

animica node up                     # background (default)
animica node up --no-detach         # foreground with logs
animica node up --with-miner        # include miner service

Verify health and sync:

bash

animica node status                 # chain head, peers, sync info
animica node head                   # latest block header
animica peer list                   # connected peers (expect >0)
animica sync status                 # detailed sync progress

💡 Fast Sync with Snapshots:

New nodes can bootstrap much faster using chain snapshots:

server.ts

# Verify snapshot system is working
python3 scripts/verify_snapshot_system.py

# Enable snapshot sync (enabled by default)
export ANIMICA_SNAPSHOT_SYNC_ENABLED=true
export ANIMICA_SNAPSHOT_RPC_URL=http://snapshots.animica.org:8545/rpc  # Optional

# Start node - automatically downloads snapshot if available
animica node up

# Or manually download/import snapshot
animica snapshot list
animica snapshot import /path/to/snapshot

See SNAPSHOT_VERIFICATION_GUIDE.md for complete guide and troubleshooting.

Ensure peers connect (connectivity checklist):

bash

animica peer list --verbose         # shows multiaddrs + scores
docker compose -f tests/devnet/docker-compose.yml -p animica-devnet logs -f node1 | grep p2p

If peer count stays 0: verify ANIMICA_P2P_SEEDS (or use defaults), open TCP/QUIC ports on your host, and confirm you selected the right network. For a manual seed bump, set:

server.ts

export ANIMICA_P2P_SEEDS="/dns4/seed.animica.org/tcp/30333"
animica node down && animica node up

Create a wallet and fund it (dev/test only):

bash

animica wallet create --label mywallet
animica faucet request mywallet     # devnet/testnet only
animica wallet show mywallet --source chain

Send a transaction (with the running node):

bash

animica tx send --from mywallet --to anim1recipient... --value 1.0
animica tx status <tx_hash>

Stop services when done:

bash

animica node down                   # keep data
animica node down --volumes         # wipe data (irreversible)

Need a deeper walkthrough? The sections below expand on each CLI area (networking, node ops, wallets, mining, RPC, Studio Services, Docker, non-Docker boot, and troubleshooting).

💰 Animica Wallet Desktop App

For users who want a simpler "just works" experience without managing the CLI, the Animica Wallet Qt provides a cross-platform desktop application with an embedded node.

Downloads

Current Release: v0.1.0 (Coming Soon)

Platform	Download	Notes
🍎 macOS	`.dmg` installer	Universal (Apple Silicon + Intel)
🪟 Windows	`.msi` installer	Windows 10/11 (x64)
🐧 Linux	`.AppImage` or `.deb`	Universal AppImage or Debian package

Installation:

macOS: Download DMG, drag to Applications folder
Windows: Download MSI, run installer
Linux AppImage: Download, chmod +x, and run
Linux DEB: sudo dpkg -i animica-wallet_*.deb

Features

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

24d ago

Most recent push to the default branch.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Animica

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "animica": { "command": "uvx", "args": ["animica-mcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/animica?style=directory)](https://allmcps.com/mcp/animica)

HTML Embed

<a href="https://allmcps.com/mcp/animica"><img src="https://allmcps.com/api/badge/animica?style=directory" alt="Animica on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

10/12 checks healthy over the last 45d

41Quality signal: Fair · 41/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity5/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · animica-mcp (PyPI)

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.