algorand-interaction

Algorand MCP Interaction

Interact with Algorand blockchain through the Algorand MCP server (126 tools across 15 categories).

Key Characteristics

• Agent-wallet signing — use wallet_* tools to sign; the MCP server holds the mnemonics in a local SQLite DB and signs on your behalf. Mnemonics are never returned in tool responses.
• Multi-network — supports mainnet, testnet, and localnet

Calling MCP Tools

MCP tools are deferred — you MUST use ToolSearch to load them before calling:

ToolSearch("+algorand wallet")                                    # Search by keyword — loads matching tools
ToolSearch("select:mcp__algorand-mcp__wallet_get_info")           # Load a specific tool by full name

Once loaded, call them normally:

mcp__algorand-mcp__wallet_get_info { "network": "testnet" }
mcp__algorand-mcp__make_payment_txn { "from": "ADDR", "to": "ADDR", "amount": 1000000, "network": "testnet" }

Full tool name pattern: mcp__algorand-mcp__<tool_name>. If you get "tool not found", use ToolSearch("+algorand <keyword>") to load it first.

Session Start Checklist

At EVERY session start:

1. Load tools first: Call ToolSearch("+algorand wallet") to load wallet tools — MCP tools are deferred and MUST be loaded via ToolSearch before use
2. Check wallet: mcp__algorand-mcp__wallet_get_info with target network — verify an account exists and is active
3. If no accounts: Guide user to create one with wallet_add_account (load via ToolSearch first)
4. If needs funding: Generate ARC-26 QR with generate_algorand_qrcode — returns { qr, uri, link, expires_in }. Display the qr text block and shareable link. Or direct to testnet faucet: https://lora.algokit.io/testnet/fund
5. If needs USDC funding: Generate ARC-26 QR with generate_algorand_qrcode — returns { qr, uri, link, expires_in }. Display the qr text block and shareable link. Or direct to testnet faucet: https://faucet.circle.com/
6. Confirm network: Always confirm which network (mainnet, testnet, localnet) before transactions
7. Load additional tools as needed: Use ToolSearch("+algorand <keyword>") to load tools for the task at hand