Algorand MCP Server: Tooling, Resources, Prompts

Overview

The Algorand MCP Server exposes the Algorand blockchain as a Model Context Protocol (MCP) server so LLMs and AI agents can interact with Algorand tools and data in a standard, secure way. It translates common blockchain operations — account and key management, transaction building/signing/submission, TEAL compilation, indexer queries, DEX/AMM actions, and more — into MCP tools that any MCP-compatible client (Claude, Cursor, Windsurf, VS Code, etc.) can call over stdio.

For developers building agent-driven workflows, this server removes the plumbing: private keys are kept safely in the OS keychain, per-account nicknames and allowances allow controlled spending, and every tool call can target mainnet, testnet, or a local node. The project includes 40+ interactive tooling actions, 60+ curated resources (docs, examples, API mappings), and ready-made prompt examples to jumpstart agent integrations.

Features

• Wallet management with OS keychain protection (private keys never exposed to agents)
• Account nicknames, allowances, and daily limits for safe automation
• Create/import/rekey accounts and manage multisig
• Build, sign, and submit transactions: payments, ASAs, applications, key registration
• Atomic transaction groups and batch workflows
• TEAL compilation, disassembly, and inspection
• Full Algod and Indexer API access via MCP tools
• NFDomains (NFD) name service support
• Integrations: Tinyman AMM, Haystack Router DEX aggregator, Alpha Arcade markets
• ARC-26 URI / QR code generation for payments
• Algorand developer knowledge base with documentation taxonomy
• Per-tool-call network selection (mainnet/testnet/localnet) and pagination
• Runs over stdio and works with any MCP-compatible client

Installation / Configuration

Requirements: Node.js v20+ and an npm/pnpm/yarn client.

Install from npm (recommended):

npm install -g @goplausible/algorand-mcp
# run
npx @goplausible/algorand-mcp

Install from source:

git clone https://github.com/GoPlausible/algorand-mcp.git
cd algorand-mcp
npm install
npm run build
node ./dist/index.js

How to invoke (stdio):

Example: add to an MCP client (Claude Desktop)

{
  "mcpServers": {
    "algorand-mcp": {
      "command": "npx",
      "args": ["@goplausible/algorand-mcp"]
    }
  }
}

Claude Code / project scope (.mcp.json)

{
  "mcpServers": {
    "algorand-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["@goplausible/algorand-mcp"]
    }
  }
}

Most clients let you add a stdio MCP server by specifying the command and args above.

Available Tools & Resources

The server groups functionality into tool categories (40+ interactions) and provides 60+ supporting resources (docs, examples, API references):

• Wallet tools: create/import, list, nickname, allowances, keychain storage
• Transaction tools: build, preview, sign (local / keychain), submit, wait for confirmation
• Grouping: create and submit atomic transaction groups
• Asset tools: ASA create/configure/transfer/opt-in
• Application tools: compile TEAL, deploy/opt-in/call apps, inspect app state
• TEAL tooling: compile, disassemble, inspect opcodes
• Node APIs: direct Algod and Indexer calls (query transactions, assets, accounts)
• DEX & AMM: Tinyman pool operations, swap quotes; Haystack best-route aggregation
• Alpha Arcade: browse markets, orderbooks, place/cancel orders, claim positions
• Utilities: ARC-26 URI/QR generation, NFD name lookup, pagination helpers
• Knowledge base: developer docs, code snippets, and taxonomy for quick reference

Full list, examples, and source code: https://github.com/GoPlausible/algorand-mcp

Use Cases (concrete examples)

• Automated funding and provisioning: create a test account, generate a QR payment (ARC-26), and fund it via an automated agent that uses allowances to limit spend.
• Atomic swaps and batching: have an agent build a 3-step atomic group (ASA transfer, app call, payment), sign using OS keychain policies and submit as a single atomic transaction.
• DEX routing for bots: query Haystack for the best swap route across Tinyman and others, preview quotes, then execute the best route programmatically.
• TEAL development loop: compile and disassemble TEAL via MCP tools, iterate in an editor-integrated agent (Claude Code) and deploy when tests pass.
• On-chain data analysis: run Indexer queries to fetch recent transactions for an address, filter asset activity, and produce a human-readable summary for auditing or reporting.
• Prediction market automation: monitor Alpha Arcade markets, place limit/market orders, and manage positions via an AI assistant that enforces daily limits.

Getting started (quick)

1. Install or use npx: npx @goplausible/algorand-mcp
2. Add the server to your MCP client (see examples above)
3. Open the client and call tools like wallet.list, tx.build, teal.compile, or dex.quote
4. Use per-call network param to target mainnet/testnet/localnet
5. Refer to the GitHub repo for examples, prompts, and the full tool list

Security notes

• Private keys are stored in the OS keychain and never returned to MCP clients.
• Use account allowances and daily limits to reduce risk when granting agents signing capability.

Tags: algorand, finance,