Iota Agent Mcp
About
MCP server for the IOTA blockchain — 20 tools for AI agent integration: wallet, Move CLI, and on-chain operations.
Details
- Author
- Scottcjn
- Downloads
- 331
- Categories
- AI
Jump to
- Stateless MCP process – no secrets stored in the agent process
- Human-in-the-loop transaction signing via local wallet server
- Dual-query: JSON-RPC for objects/transactions, GraphQL for aggregate stats
- CLI passthrough for Move build, test, and unsigned publish commands
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Iota Agent McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install globally via npm install -g iota-agent-mcp. Then configure an MCP client by adding a server entry with the command iota-agent-mcp (for Claude Code) or npx iota-agent-mcp (for Cursor / VS Code) in the respective settings JSON file. Optional environment variables configure the local agent-wallet server (IOTA_WALLET_SERVER), JSON-RPC endpoint (IOTA_RPC_URL), and GraphQL indexer (IOTA_GRAPHQL_URL).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"iota agent mcp": {
"iota": {
"command": "npx",
"args": [
"iota-agent-mcp"
]
}
}
}
}McpServers
{
"iota": {
"command": "npx",
"args": [
"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 binaryQuick Start
Install
``
bash
npm install -g iota-agent-mcp
`
Claude Code
json
// ~/.claude/settings.json
{
"mcpServers": {
"iota": {
"command": "iota-agent-mcp"
}
}
}
`
Cursor / VS Code
json
// .cursor/mcp.json or .vscode/mcp.json
{
"servers": {
"iota": {
"command": "npx",
"args": ["iota-agent-mcp"]
}
}
}
`
Configuration
Environment variables:
| Variable | Default | Description |
|----------|---------|-------------|
| | 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
`bash
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
