IOTA Agent MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
npm install -g iota-agent-mcp
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add iota-agent -- node "<FULL_PATH_TO_IOTA_AGENT_MCP>/dist/index.js"

Replace <FULL_PATH_TO_IOTA_AGENT_MCP>/dist/index.js with the actual folder you prepared in step 1.

README.md

MCP server for IOTA blockchain interaction and Move smart contract development.

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

20 tools across 4 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 (8 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

┌──────────────────────┐     stdio      ┌──────────────────────┐
│  AI Agent (Claude,   │ ◀────────────▶ │  iota-agent-mcp      │
│  Cursor, VS Code)    │                │  (this server)       │
└──────────────────────┘                └───┬──────┬──────┬────┘
                                            │      │      │
                                    HTTP    │  RPC │  GQL │
                                            ▼      ▼      ▼
                                   ┌────────┐ ┌────────┐ ┌────────┐
                                   │ Agent  │ │  IOTA  │ │  IOTA  │
                                   │ Wallet │ │  Node  │ │  GQL   │
                                   │:3847   │ │  RPC   │ │Indexer │
                                   └────────┘ └────────┘ └────────┘
  • 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

Tools (18)

iota_wallet_addressGet active wallet address
iota_wallet_balanceCheck IOTA balance
iota_wallet_accountsList all derived accounts
iota_wallet_sign_executeSign and execute transactions (human-in-the-loop)
iota_wallet_pendingView pending signing requests
iota_wallet_approveApprove a pending request
iota_wallet_rejectReject a pending request
iota_wallet_switch_networkSwitch mainnet/testnet/devnet
iota_cliRun any IOTA CLI command
iota_move_buildBuild a Move package
iota_move_test_coverageRun tests with coverage analysis
iota_move_publish_unsignedGenerate unsigned publish transaction
iota_objectFetch object data by ID
iota_objects_by_ownerList objects owned by an address
iota_transactionFetch transaction by digest
iota_coinsGet coin objects for an address
iota_epoch_infoCurrent epoch and network stats (GraphQL)
iota_decompileDecompile deployed Move modules

Environment Variables

IOTA_WALLET_SERVERAgent wallet server URL
IOTA_RPC_URLIOTA JSON-RPC endpoint
IOTA_GRAPHQL_URLIOTA GraphQL indexer

Configuration

claude_desktop_config.json
{
  "mcpServers": {
    "iota": {
      "command": "iota-agent-mcp"
    }
  }
}

Try it

→Check the current balance of my active IOTA wallet.
→Build the Move package in the current directory and run tests with coverage analysis.
→Fetch the object data for the IOTA object ID 0x123...
→List all objects currently owned by my wallet address.
→Switch the network to testnet and get the current epoch information.

Frequently Asked Questions

What are the key features of IOTA Agent?

Direct interaction with IOTA blockchain via AI agents. Human-in-the-loop security model for transaction signing. Full support for Move smart contract build, test, and publish workflows. Dual query support using JSON-RPC and GraphQL. Stateless architecture ensuring no secrets are stored in the MCP process.

What can I use IOTA Agent for?

Automating Move smart contract development and testing cycles. Managing IOTA wallet assets and transaction signing through natural language. Querying on-chain data and network statistics for research or monitoring. Integrating IOTA blockchain operations into existing AI-assisted coding workflows.

How do I install IOTA Agent?

Install IOTA Agent by running: npm install -g iota-agent-mcp

What MCP clients work with IOTA Agent?

IOTA Agent works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep IOTA Agent docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all other servers →

Related MCP Servers

Nuclear
Free, open-source music player without ads or tracking.
other17.1K stars
Domain Check
Fast domain availability checker with RDAP/WHOIS lookup and batch checking.
other253 stars
US Government Open Data MCP
MCP Server + TypeScript SDK for 40+ U.S. Government APIs
other90 stars
Garmin Connect
Access your fitness, health, and training data from MCP clients.
other71 stars
BinjaLattice MCP
Secure communication protocol for Binary Ninja and MCP servers
other61 stars
Ghidra Headless MCP
Headless Ghidra server for AI-driven reverse engineering and analysis
other46 stars