iota-agent-mcp

name iota-agent-mcp description IOTA blockchain MCP server providing wallet management with human-in-the-loop signing, Move smart contract build/test/publish, and on-chain queries via JSON-RPC and GraphQL. Use when interacting with IOTA network from AI coding agents, managing IOTA wallets, building or publishing Move packages, querying on-chain objects or transactions, or checking epoch and network statistics. IOTA Agent MCP MCP server that connects AI coding agents to the IOTA blockchain. Provides 18 tools across wallet operations, Move smart contract development, and on-chain data queries — all via stdio transport with no secrets in the MCP process. Workflow Configure the MCP server in your agent's settings (Claude Code, Cursor, VS Code Copilot) Query on-chain data — fetch objects, transactions, coins, epoch info, or decompile modules Develop Move contracts — build, test with coverage, generate unsigned publish transactions Sign and publish — generate unsigned transaction, submit via iota_wallet_sign_execute , check iota_wallet_pending for approval status, verify on-chain with iota_transaction Signing flow (human-in-the-loop) Wallet operations that modify state require human approval: Call iota_wallet_sign_execute with base64-encoded transaction bytes — creates a pending request Call iota_wallet_pending to confirm the request was queued The human approves ( iota_wallet_approve ) or rejects ( iota_wallet_reject ) via the agent-wallet server On approval, verify the transaction landed on-chain: call iota_transaction with the returned digest If rejected, inform the user and do not retry without explicit instruction Tools Wallet (8 tools) iota_wallet_address — Get the active wallet address iota_wallet_balance — Check IOTA balance for the active wallet iota_wallet_accounts — List all derived wallet accounts iota_wallet_sign_execute — Sign and execute a transaction (requires human approval via agent-wallet server) iota_wallet_pending — List pending signing requests awaiting approval iota_wallet_approve — Approve a pending signing request by ID iota_wallet_reject — Reject a pending signing request by ID iota_wallet_switch_network — Switch between mainnet, testnet, and devnet Move CLI (4 tools) iota_cli — Run any IOTA CLI command (e.g. client gas , move new my_project ) iota_move_build — Compile a Move package and report build results iota_move_test_coverage — Run Move tests with coverage analysis and summary iota_move_publish_unsigned — Generate unsigned publish transaction for agent-wallet signing On-Chain Query (6 tools) iota_object — Fetch object data by ID (owner, type, version, content) iota_objects_by_owner — List objects owned by an address iota_transaction — Fetch transaction details by digest (input, effects, events) iota_coins — Get coin objects for gas estimation and token queries iota_epoch_info — Current epoch, checkpoint, and network statistics via GraphQL iota_decompile — Retrieve and decompile a deployed Move module's ABI Examples Build and test a Move package: iota_move_build(path: "./my_move_project") → "BUILDING my_move_project ... Build Successful" iota_move_test_coverage(path: "./my_move_project") → "## Test Results\nRunning Move unit tests ... 5 tests passed\n\n## Coverage Summary\n85.7% coverage" Query an on-chain object: iota_object(object_id: "0xabc123...") → { "owner": "0xdef456...", "type": "0x2::coin::Coin<0x2::iota::IOTA>", "version": 42, "content": {...} } Publish a Move package with wallet signing: iota_move_publish_unsigned(path: "./my_move_project", gas_budget: "500000000") → "AAACAQBk..." (base64 tx bytes) iota_wallet_sign_execute(tx_bytes: "AAACAQBk...") → "Request queued (id: req-1). Awaiting human approval." Configuration Set environment variables to override defaults: IOTA_WALLET_SERVER — Agent wallet server URL (default: http://localhost:3847 ) IOTA_RPC_URL — IOTA JSON-RPC endpoint (default: mainnet) IOTA_GRAPHQL_URL — IOTA GraphQL indexer (default: mainnet) Setup npm install -g iota-agent-mcp // Claude Code: ~/.claude/settings.json { "mcpServers" : { "iota" : { "command" : "iota-agent-mcp" } } } // Cursor / VS Code: .cursor/mcp.json or .vscode/mcp.json { "servers" : { "iota" : { "command" : "npx" , "args" : [ "iota-agent-mcp" ] } } }