IOTA Agent MCP

iota-agent-mcp

MCP (Model Context Protocol) server for IOTA blockchain. Enables AI coding agents (Claude Code, Cursor, VS Code Copilot, ChatGPT) to interact directly with the IOTA network.

Tools

18 tools across 3 categories:

Wallet (8 tools)

Tool	Description
`iota_wallet_address`	Get active wallet address
`iota_wallet_balance`	Check IOTA balance
`iota_wallet_accounts`	List all derived accounts
`iota_wallet_sign_execute`	Sign and execute transactions (human-in-the-loop)
`iota_wallet_pending`	View pending signing requests
`iota_wallet_approve`	Approve a pending request
`iota_wallet_reject`	Reject a pending request
`iota_wallet_switch_network`	Switch mainnet/testnet/devnet

CLI & Move (4 tools)

Tool	Description
`iota_cli`	Run any IOTA CLI command
`iota_move_build`	Build a Move package
`iota_move_test_coverage`	Run tests with coverage analysis
`iota_move_publish_unsigned`	Generate unsigned publish transaction

On-Chain Query (6 tools)

Tool	Description
`iota_object`	Fetch object data by ID
`iota_objects_by_owner`	List objects owned by an address
`iota_transaction`	Fetch transaction by digest
`iota_coins`	Get coin objects for an address
`iota_epoch_info`	Current epoch and network stats (GraphQL)
`iota_decompile`	Decompile deployed Move modules

Architecture

flowchart LR
    client["AI coding agent<br/>Claude Code, Cursor, VS Code Copilot, ChatGPT"]
    mcp["iota-agent-mcp<br/>stateless stdio MCP server"]
    wallet["Local agent-wallet server<br/>IOTA_WALLET_SERVER<br/>default http://localhost:3847"]
    rpc["IOTA JSON-RPC fullnode<br/>IOTA_RPC_URL<br/>default https://api.mainnet.iota.cafe"]
    gql["IOTA GraphQL indexer<br/>IOTA_GRAPHQL_URL<br/>default https://graphql.mainnet.iota.cafe"]
    cli["iota CLI and Move toolchain<br/>build, test, unsigned publish"]
    rustchain["RustChain / Elyan Labs ecosystem<br/>BCOS and agent workflow context"]

    client <-->|"MCP over stdio"| mcp
    mcp -->|"wallet address, balance, accounts"| wallet
    mcp -->|"sign / approve / reject requests"| wallet
    mcp -->|"object, transaction, coins"| rpc
    mcp -->|"epoch and network stats"| gql
    mcp -->|"execFile without shell"| cli
    rustchain -. "ecosystem docs and certification" .- mcp

Stateless — no secrets in the MCP process
Human-in-the-loop — wallet ops proxy to a local agent-wallet server with approval flow
Dual query — JSON-RPC for object/tx queries, GraphQL for aggregate stats
CLI passthrough — Move build/test/publish via iota binary

Quick Start

Install

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"]
    }
  }
}

Configuration

Environment variables:

Variable	Default	Description
`IOTA_WALLET_SERVER`	`http://localhost:3847`	Agent wallet server URL
`IOTA_RPC_URL`	`https://api.mainnet.iota.cafe`	IOTA JSON-RPC endpoint
`IOTA_GRAPHQL_URL`	`https://graphql.mainnet.iota.cafe`	IOTA GraphQL indexer

Development

git clone https://github.com/Scottcjn/iota-agent-mcp.git
cd iota-agent-mcp
npm install
npm run build    # Compile TypeScript
npm run dev      # Run with tsx (hot reload)
npm test         # Run tests

License

Apache-2.0

Part of the Elyan Labs Ecosystem

BoTTube — AI video platform where 119+ agents create content
RustChain — Proof-of-Antiquity blockchain with hardware attestation
GitHub

README