Local key storage
Seeds are generated and kept in ~/.ironwallet-mcp on your machine, with owner-only file permissions.
IronWallet MCP for AI assistants
Control a dedicated IronWallet wallet from your AI assistant using MCP. Check balances, send, swap and manage your crypto with natural language.
Before you start
What's my USDT balance across networks?
Send 25 USDT to my saved Arbitrum address.
Transaction preview
Amount
25.00 USDT
Illustrative interface · demo data
Product value
Wallet tasks that used to take a dozen screens become one sentence to your AI assistant. IronWallet MCP gives it the tools — your keys stay on your machine.
Before
With IronWallet MCP
Illustrative interface · demo data
Real MCP examples
Pick a task to see the conversation and the IronWallet MCP tool calls behind it. All values are demo data — nothing here touches a blockchain.
You
What's my USDT balance?
Tool calls
Check balances in seconds
Native and token balances, read straight from the networks your wallet uses.
Total
650.50 USDT
→ list_wallets()→ get_balance(token: "USDT", network: "tron")→ get_balance(token: "USDT", network: "arbitrum")→ get_balance(token: "USDT", network: "ethereum")How it works
Your AI assistant only ever talks to tools. The IronWallet MCP server does the wallet work on your computer, signs locally and broadcasts the result.
You ask in plain language. The assistant picks the right IronWallet tool.
“Send 10 USDT…”A local MCP server exposes a fixed set of wallet tools. No tool accepts or returns a seed.
send_transferKeys are decrypted and used on your machine to sign. Optional wallet policies are checked first.
signed on deviceThe signed transaction is broadcast. Status can be polled until it settles.
get_operation_statusBy default your chat message is the authorization — there is no separate confirmation screen. You can ask your assistant to always confirm first, or restrict the wallet with policies.
Security
IronWallet MCP is a non-custodial hot wallet that lives on your computer. The AI calls tools — it never sees your seed phrase or private keys.
ImportantAI agents may execute transactions within configured permissions without an additional confirmation step. Use a dedicated wallet with limited funds.
Seeds are generated and kept in ~/.ironwallet-mcp on your machine, with owner-only file permissions.
Recovery phrases are encrypted at rest and never appear in tool results, chat, logs or backend requests.
Transactions are signed on your computer. IronWallet backends see signed transactions and swap payloads, not the seed.
Optional per-wallet limits: maximum USD per transaction and a recipient allow-list. Off by default.
Make a wallet read-only, or set IW_READ_ONLY=true to block sends and swaps for the whole server.
Never import your main or savings wallet. Create a small dedicated wallet and fund only what you're comfortable using.
Setup
Three stages, a few minutes. Desktop only — the MCP server runs on your computer through npx.
01
Add the IronWallet MCP server to your AI client with one command or one config block. Requires Node.js 20+.
02
Ask the assistant to create a wallet, or open the local wallet manager in your browser to import one. Back up the recovery phrase there.
03
Reload your client and start a new chat. Fund the wallet with a small amount and try a simple prompt.
Choose your AI client
Paste this into ~/.cursor/mcp.json, then reload Cursor so npx is on your PATH. First start can take about 30 seconds.
{
"mcpServers": {
"ironwallet": {
"command": "npx",
"args": ["-y", "@ironwallet/mcp-server"]
}
}
}Supported networks
Check balances, receive and transfer across the 12 networks listed in the current IronWallet MCP documentation.
Swap availability depends on the network and asset. Your assistant checks the live catalog with list_swap_networks and list_swap_assets before quoting.
FAQ
Yes. You need the IronWallet MCP server (@ironwallet/mcp-server), which runs locally on your desktop and needs Node.js 20+. Your AI client starts it through npx, and it is seed-compatible with the IronWallet app.
You need a ready wallet, but you can create it in a minute. Ask your assistant to create one, or import an existing wallet in the local wallet manager in your browser. For safety, use a new dedicated wallet rather than your main one.
The official guides cover Cursor, Claude Code, VS Code and ChatGPT (via Codex). Any other MCP client with stdio transport can connect with the standard configuration. Desktop only.
Yes. The assistant can send and swap, and by default it does so without a separate confirmation screen — your chat message is the authorization. You can tell it to always confirm first, and you can limit it with read-only mode, a maximum amount per transaction or a recipient allow-list.
On your computer, in ~/.ironwallet-mcp, encrypted at rest with owner-only file permissions. Keys are used locally to sign and are never shared with the AI, the model provider or IronWallet backends. Your backup is the recovery phrase, so don't delete this folder without one.
Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP and TON, according to the current documentation. Swaps are available for the networks and assets in the live swap catalog.
IronWallet's documentation doesn't publish a price for the MCP server; it is distributed as a public npm package. Blockchain network fees apply to transfers and swaps, and your AI client may require its own subscription. Check the official documentation for current terms.
Add the IronWallet MCP server to your AI client, create or import a dedicated wallet in the local wallet manager, fund it with a small amount and start a new chat. Then ask something simple, like “What's my balance?”.
Install IronWallet MCP, connect a dedicated wallet and start managing crypto in plain language.