iota-agent-mcp
The iota-agent-mcp server is an MCP (Model Context Protocol) server enabling AI agents to interact with the IOTA blockchain across three main areas:
Wallet Management
Get active wallet address and check balance
List all derived wallet accounts
Sign and execute transactions with human-in-the-loop approval
View, approve, or reject pending signing requests
Switch between mainnet, testnet, and devnet
CLI & Move Smart Contract Development
Run arbitrary IOTA CLI commands
Build Move packages and report compilation results
Run Move tests with coverage analysis
Generate unsigned publish transactions for Move packages
On-Chain Data Querying
Fetch object data by ID (owner, type, version, content)
List objects owned by a specific address
Retrieve transaction details by digest
Get coin objects for an address (useful for gas estimation)
Query current epoch, checkpoint, and network stats via GraphQL
Decompile deployed Move modules to view their ABI (structs, functions, type parameters)
Enables comprehensive interaction with the IOTA blockchain, allowing for wallet management, transaction signing and execution, on-chain queries for objects and transactions, and Move smart contract development including building, testing, and publishing modules.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@iota-agent-mcpcheck my active wallet address and current IOTA balance"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Get active wallet address |
| Check IOTA balance |
| List all derived accounts |
| Sign and execute transactions (human-in-the-loop) |
| View pending signing requests |
| Approve a pending request |
| Reject a pending request |
| Switch mainnet/testnet/devnet |
CLI & Move (4 tools)
Tool | Description |
| Run any IOTA CLI command |
| Build a Move package |
| Run tests with coverage analysis |
| Generate unsigned publish transaction |
On-Chain Query (6 tools)
Tool | Description |
| Fetch object data by ID |
| List objects owned by an address |
| Fetch transaction by digest |
| Get coin objects for an address |
| Current epoch and network stats (GraphQL) |
| Decompile deployed Move modules |
Related MCP server: 0g-mcp-server
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" .- mcpStateless — 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
iotabinary
Quick Start
Install
npm install -g iota-agent-mcpClaude 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 |
|
| Agent wallet server URL |
|
| IOTA JSON-RPC endpoint |
|
| 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 testsLicense
Apache-2.0
Part of the Elyan Labs Ecosystem
Maintenance
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Scottcjn/iota-agent-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server