IOTA Agent
An MCP server that enables AI agents to interact with the IOTA blockchain, supporting wallet management, transaction signing, and Move smart contract development. It provides tools for on-chain queries and CLI operations with a human-in-the-loop secu
What is IOTA Agent?
IOTA Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that enables ai agents to interact with the iota blockchain, supporting wallet management, transaction signing, and move smart contract development. it provides tools for on-chain queries a...
An MCP server that enables AI agents to interact with the IOTA blockchain, supporting wallet management, transaction signing, and Move smart contract development. It provides tools for on-chain queries and CLI operations with a human-in-the-loop secu
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An MCP server that enables AI agents to interact with the IO
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx iota-agentConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use IOTA Agent
iota-agent-mcp is an MCP server that gives AI agents a full interface to the IOTA blockchain, covering wallet management, transaction signing, on-chain queries, and Move smart contract development. It exposes 18 tools across wallet operations, CLI command execution, and chain queries, while enforcing a human-in-the-loop approval step for any transaction that moves funds. Blockchain developers and DeFi researchers use it to build, test, and interact with IOTA smart contracts directly from their AI assistant.
Prerequisites
- Node.js and npm installed
- A local IOTA agent-wallet server running on port 3847 (see the iota-agent-mcp repository for setup instructions)
- Network access to the IOTA mainnet RPC and GraphQL endpoints, or a custom node URL
- An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with an MCP extension
Install iota-agent-mcp globally
Install the package globally with npm so the iota-agent-mcp binary is available on your PATH for use by MCP clients.
npm install -g iota-agent-mcpStart the local wallet server
The MCP server communicates with a local agent-wallet server on port 3847 that manages your IOTA keys securely. Follow the wallet server setup instructions in the repository to start it before launching the MCP server.
# Default endpoint expected by the MCP server:
# http://localhost:3847Configure environment variables
Optionally set IOTA_WALLET_SERVER, IOTA_RPC_URL, and IOTA_GRAPHQL_URL if you want to use a custom node or testnet instead of the mainnet defaults.
export IOTA_WALLET_SERVER=http://localhost:3847
export IOTA_RPC_URL=https://api.mainnet.iota.cafe
export IOTA_GRAPHQL_URL=https://graphql.mainnet.iota.cafeConfigure your MCP client
Add the iota-agent-mcp server to your client configuration. The server uses stdio transport and requires no additional arguments.
Verify connectivity
Ask your AI assistant to fetch your wallet address or check your IOTA balance to confirm the MCP server is connected and communicating with the wallet server and RPC endpoint correctly.
IOTA Agent Examples
Client configuration
Configuration for Claude Desktop (claude_desktop_config.json) and Cursor (.cursor/mcp.json). Both connect to the globally installed binary.
{
"mcpServers": {
"iota": {
"command": "iota-agent-mcp",
"env": {
"IOTA_WALLET_SERVER": "http://localhost:3847",
"IOTA_RPC_URL": "https://api.mainnet.iota.cafe",
"IOTA_GRAPHQL_URL": "https://graphql.mainnet.iota.cafe"
}
}
}
}Prompts to try
Example prompts that use the 18 IOTA tools exposed by the MCP server.
- "What is the IOTA balance of my active wallet address?"
- "Fetch on-chain details for transaction [transaction digest]"
- "Build and test my Move package at ./my_contract/"
- "Generate an unsigned transaction to send 10 IOTA to [recipient address] for my review"
- "List all coins owned by address [address] on IOTA mainnet"
- "Decompile the Move module at object ID [id] and show me the source"Troubleshooting IOTA Agent
Connection refused to wallet server at localhost:3847
The IOTA agent-wallet server must be running before the MCP server starts. Follow the wallet server setup guide in the iota-agent-mcp repository and confirm the process is listening on port 3847 ('lsof -i :3847').
RPC timeout errors when querying the chain
The mainnet RPC endpoints may be temporarily overloaded. Set IOTA_RPC_URL and IOTA_GRAPHQL_URL to a dedicated node or testnet endpoint and retry.
Transaction requires approval but no approval prompt appears
Human-in-the-loop approval is handled by the wallet server UI. Open the wallet server's local web interface (usually http://localhost:3847) and check for pending approval requests.
Frequently Asked Questions about IOTA Agent
What is IOTA Agent?
IOTA Agent is a Model Context Protocol (MCP) server that mcp server that enables ai agents to interact with the iota blockchain, supporting wallet management, transaction signing, and move smart contract development. it provides tools for on-chain queries and cli operations with a human-in-the-loop secu It connects AI assistants to external tools and data sources through a standardized interface.
How do I install IOTA Agent?
Follow the installation instructions on the IOTA Agent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with IOTA Agent?
IOTA Agent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is IOTA Agent free to use?
Yes, IOTA Agent is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
IOTA Agent Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to IOTA Agent? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up IOTA Agent in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use IOTA Agent?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.