GoPlausible/algorand-mcp

A comprehensive Model Context Protocol (MCP) server that gives AI agents and LLMs full access to the Algorand blockchain. Built by GoPlausible.
Algorand is a carbon-negative, pure proof-of-stake Layer 1 blockchain with instant finality, low fees, and built-in support for smart contracts (AVM), standard assets (ASAs), and atomic transactions.
What is MCP?
Model Context Protocol is an open standard that lets AI applications connect to external tools and data sources. This server exposes Algorand blockchain operations as MCP tools that any compatible AI client can use — Claude Desktop, Claude Code, Cursor, Windsurf, and others.
Features
- Agent wallet — mnemonics stored in a local SQLite database, used by the MCP server to sign on the agent's behalf (mnemonics never returned in tool responses)
- Wallet accounts with human-readable nicknames
- Account creation, key management, and rekeying
- Transaction building, signing, and submission (payments, assets, applications, key registration)
- Atomic transaction groups
- TEAL compilation and disassembly
- Full Algod and Indexer API access
- NFDomains (NFD) name service integration
- x402 HTTP micropayments — automatic discovery and one-call paid requests using the active wallet (USDC/ALGO)
- AP2 tooling for Algorand
- Tinyman AMM integration (pools, swaps, liquidity)
- Haystack Router DEX aggregation (best-price swaps across Tinyman, Pact, Folks)
- Alpha Arcade prediction market trading (browse markets, orderbooks, limit/market orders, positions, claims)
- ARC-26 URI and QR code generation
- Algorand knowledge base with full developer documentation taxonomy
- Per-tool-call network selection (mainnet, testnet, localnet) and pagination
Requirements
- Node.js v20 or later
- npm, pnpm, or yarn
Installation
From npm
From source
MCP Configuration
The server runs over **stdio**. There are three ways to invoke it — pick whichever suits your setup:
| Method | Command | When to use |
|---|---|---|
| **npx** (recommended) | npx @goplausible/algorand-mcp | No install needed, always latest version |
| **Global install** | algorand-mcp | After npm install -g @goplausible/algorand-mcp |
| **Absolute path** | node /path/to/dist/index.js | Built from source or local clone |
**No environment variables are required** for standard use. Network selection, pagination, and node URLs are all handled dynamically per tool call.
---
OpenClaw
No manual configuration needed — install the @goplausible/openclaw-algorand-plugin npm package and the Algorand MCP server is configured automatically:
---
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
**Using npx:**
**Using global install:**
**Using absolute path:**
---
Claude Code
Create .mcp.json in your project root (project scope) or ~/.claude.json (user scope):
Or add interactively:
---
Cursor
Add via **Settings > MCP Servers**, or edit .cursor/mcp.json in your project root:
---
Windsurf
Add via **Settings > MCP**, or edit ~/.codeium/windsurf/mcp_config.json:
---
VS Code / GitHub Copilot
Edit .vscode/mcp.json in your workspace root, or open **Settings > MCP Servers**:
---
Cline
Add via the **MCP Servers** panel in the Cline sidebar, or edit ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json (macOS):
---
OpenAI Codex CLI
Create .codex/mcp.json in your project root or ~/.codex/mcp.json for global scope:
---
Open Code
Edit ~/.config/opencode/config.json:
---
Any MCP-compatible client
The server speaks the standard MCP stdio protocol. For any client not listed above, configure it with:
- **Command:** npx (or algorand-mcp if globally installed, or node /path/to/dist/index.js)
- **Args:** ["@goplausible/algorand-mcp"] (for npx)
- **Transport:** stdio
Network Selection
Every tool accepts an optional network parameter: "mainnet" (default), "testnet", or "localnet". Algod and Indexer URLs are built-in for mainnet and testnet via AlgoNode.
Example tool call:
If no network is provided, tools default to **mainnet**.
Pagination
API responses are automatically paginated. Every tool accepts an optional itemsPerPage parameter (default: 10). Pass the pageToken from a previous response to fetch the next page.
Agent Wallet
Architecture
The agent wallet is a local SQLite database that the MCP server controls on the agent's behalf. The server holds the mnemonics and signs transactions for the agent — the agent never sees the mnemonics in any tool response.