Ironwallet is the best online crypto wallet in the world.Ironwallet is the best online crypto wallet in the world.
Kosten calculatorSaldo checkerTronScanner - check transactions in the Tron blockchain.Tronscanner

MCP instellen

Installeer en configureer de IronWallet MCP-server voor Cursor, Claude Code, ChatGPT en andere MCP-clients.

De IronWallet MCP-server (@ironwallet/mcp-server) geeft AI-agents een non-custodial cryptowallet op je computer. Seed-phrases worden lokaal gegenereerd en versleuteld — ze verlaten nooit deze machine en gaan nooit via de agent, de LLM of IronWallet-backends. Agents kunnen saldi controleren, stortings-QR-codes tonen, tokens overmaken en swappen over 12 netwerken: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP en TON.

Er is geen UI voor bevestiging per transactie — zodra je de agent vraagt om te verzenden of te swappen, kan deze ondertekenen en uitzenden zonder het opnieuw te vragen. Gebruik een speciale hot wallet met een beperkt saldo, nooit je hoofdwallet.

Vereisten: Node.js 20+ (npx). Alleen desktop / stdio.

Functies

Non-custodial, lokaal ondertekenen

Seed-phrases blijven versleuteld op de host (alleen-eigenaar-bestandsrechten). Transacties worden op deze machine ondertekend; geen enkele tool accepteert of retourneert een seed.

Wallets in de lokale browser

Maak wallets aan met create_wallets (retourneert een backup_url), of importeer en back-up via open_wallet_manager — een pagina die alleen op 127.0.0.1 werkt en afsluit na 15 minuten inactiviteit. Geheimen verschijnen alleen in die browserpagina, nooit in de chat.

Overboekingen met schattingen van kosten

estimate_transfer toont de kosten zonder uit te zenden; send_transfer ondertekent lokaal en verzendt; get_operation_status pollt het resultaat. De server kan het bedrag iets verlagen zodat de kosten binnen het saldo passen — het antwoord geeft aan wanneer dat is gebeurd.

Catalogusgestuurde swaps

list_swap_networks en list_swap_assets bieden de verkoop/koop-catalogus zodat de agent nooit tokenadressen verzint. estimate_swap geeft een prijsopgave, execute_swap voert uit op een verse prijsopgave, get_swap_status pollt.

Stortings-QR-codes

get_deposit_qr retourneert een PNG voor de chat plus een lokale qr_url-fallback.

Optionele bestedingslimieten

Per-wallet beleid via set_wallet_policy: readOnly, maxPerTxUsd en een toegestane lijst voor ontvangers. Standaard uitgeschakeld; geldt voor zowel verzendingen als swaps. IW_READ_ONLY=true maakt de hele server alleen-lezen.

Installatie

Optie 1: npx (aanbevolen)

Gebruik npx om de server uit te voeren zonder globale installatie. Dit zorgt ervoor dat je altijd de nieuwste versie gebruikt.

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

De eerste lancering kan ongeveer 30 seconden duren terwijl afhankelijkheden worden geïnstalleerd. Als je MCP-client een time-out geeft, voer het commando dan eenmaal uit in een terminal om de cache op te warmen en maak daarna opnieuw verbinding.

Optie 2: Globale installatie

Installeer het pakket globaal voor snellere opstarttijd, voer daarna ironwallet-mcp uit.

npm install -g @ironwallet/mcp-server@latest

Installatiehandleidingen

Alleen voor desktop

Elke client heeft een speciale statische URL (bijvoorbeeld /ai/introduction/vscode/). Alle installatiecommando's hieronder staan ook inline op deze pagina — geen tabbladen, niets verborgen achter kliks.

Cursor

Meest aanbevolen

Meest aanbevolen

Werkt goed met de gratis versie, eenvoudige installatie, beste ervaring

Openen in Cursor

Installeer eenmaal. Daarna zijn de wallet-tools beschikbaar in elke chat. Je kunt dit ook in ~/.cursor/mcp.json plakken en Cursor herstarten.

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Herlaad Cursor na installatie zodat PATH npx bevat.

Standalone pagina voor Cursor — één HTTP-fetch retourneert alleen deze handleiding.

Claude Code

Vereist een hoger expertiseniveau

Werkt goed met Code-modus, Chat-modus is zeer beperkt

Openen in Claude Code

Voer deze commando's in volgorde uit:

1claude plugin marketplace add ironwallet/ironwallet-agent-kit
2claude plugin install ironwallet-mcp@ironwallet

Wacht na plugin-installatie ongeveer 45 seconden en start een nieuwe chat zodat de tools worden geladen.

Of verwijs Claude Code direct naar de stdio-server:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Standalone pagina voor Claude Code — één HTTP-fetch retourneert alleen deze handleiding.

VS Code

Hoogste expertiseniveau

Vereist extra plugins bij de betaalde versie van AI-modellen

Openen in VS Code

Opent VS Code en registreert de lokale MCP-server. Je kunt dit ook toevoegen aan je VS Code MCP-instellingen (gebruiker of werkruimte).

1{
2 "mcp": {
3 "servers": {
4 "ironwallet": {
5 "type": "stdio",
6 "command": "npx",
7 "args": ["-y", "@ironwallet/mcp-server"]
8 }
9 }
10 }
11}

Standalone pagina voor VS Code — één HTTP-fetch retourneert alleen deze handleiding.

ChatGPT

Eenvoudige installatie - vereist ChatGPT

Gratis versie is zeer beperkt, betaalde versie werkt beter

Openen in ChatGPT

Voer deze commando's in volgorde uit en herlaad daarna zodat de MCP-tools beschikbaar zijn.

1codex plugin marketplace add ironwallet/ironwallet-agent-kit
2codex plugin add ironwallet-mcp@ironwallet

Of verwijs ChatGPT direct naar de stdio-server:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Standalone pagina voor ChatGPT — één HTTP-fetch retourneert alleen deze handleiding.

Andere clients

Gebruik het stdio-transport. Verwijs je MCP-client naar:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Standalone pagina voor Andere clients — één HTTP-fetch retourneert alleen deze handleiding.

Eerste keer opstarten & wallet instellen

Er is geen aanmelding en geen account. Bij de eerste lancering genereert de server zijn lokale geheimen — een relay API-sleutel, een keystore-wrapping-geheim en een apparaat-ID — onder ~/.ironwallet-mcp/ met alleen-eigenaar-rechten. Niets om te configureren.

Om een wallet te gaan gebruiken:

1
Toestemming. Voordat een wallet wordt aangemaakt of geïmporteerd, toont de agent de MCP-disclaimer in de chat en registreert je acceptatie (accept_mcp_consent), of je drukt op Doorgaan in de wallet-manager.
2
Aanmaken of importeren. create_wallets retourneert walletnamen en adressen plus een backup_url — open deze in je browser om de herstelzin te bekijken en te back-uppen. Gebruik open_wallet_manager om een bestaande wallet te importeren of later een back-up te maken. De herstelzin wordt alleen in de lokale browserpagina getypt of getoond, nooit in de chat.
3
De wallet financieren. Vraag de agent om een stortings-QR (get_deposit_qr) of een adres (list_wallets) en stuur een klein bedrag. Houd het saldo beperkt — dit is een hot wallet.

Gegevens op schijf

De server houdt zijn status bij in ~/.ironwallet-mcp/ (overschrijf met IW_KEYSTORE_DIR):

de versleutelde keystore met je wallet-seeds,

het wrapping-geheim, de relay API-sleutel en het apparaat-ID,

diagnostische logs onder logs/ (seed-materiaal wordt nooit gelogd).

Waarschuwing: verwijder deze map niet om de server te "resetten".

Deze bevat de versleutelde sleutels voor je fondsen. Als je deze verwijdert zonder de herstelzin in de wallet-manager te hebben geback-upt, zijn de fondsen verloren. Je back-up is de herstelzin, niet deze bestanden.

Iedereen met de keystore en het wrapping-geheim beheert de fondsen, dus behandel de map als gevoelig.

Omgevingsvariabelen

De meeste gebruikers hoeven geen omgevingsvariabelen in te stellen. De server genereert en slaat alles wat nodig is op bij de eerste lancering. Het volgende is beschikbaar voor geavanceerd gebruik:

Variabele
Beschrijving
Standaard
IW_READ_ONLY
Weiger send_transfer en execute_swap procesbreed. Onderscheidend van per-wallet policy.readOnly
false
IW_KEYSTORE_DIR
Keystore-directory
~/.ironwallet-mcp
IW_PASSPHRASE
Overschrijf het keystore-wrapping-geheim
generated locally
IW_RELAY_API_KEY
Overschrijf de relay API-sleutel
generated UUID
IW_HTTP_TIMEOUT_MS
Algemene HTTP-time-out
15000
IW_HTTP_FORWARD_TIMEOUT_MS
Time-out voor broadcast-stijl aanroepen. Een client-time-out betekent niet altijd dat de operatie is mislukt — controleer de status
60000
IW_LOG_ENABLED
JSONL-diagnostiek naar een logbestand (0 om uit te schakelen)
1
IW_LOG_LEVEL
debug / info / warn / error
info

Beveiliging

Seeds verlaten deze machine nooit. Ze zijn in rust versleuteld en verschijnen nooit in tool-resultaten, agent-chat, logs of backend-verzoeken. Geen enkele tool accepteert of retourneert een seed — importeren en back-uppen gebeurt alleen in de lokale browser.

De agent kan fondsen verplaatsen zonder het opnieuw te vragen. Er is geen UI voor bevestiging per transactie; je chatbericht is de autorisatie. Overboekingen en swaps zijn onomkeerbaar zodra ze zijn uitgezonden.

Optionele limieten. Per-wallet beleid (readOnly, maxPerTxUsd, toegestane lijst voor ontvangers) via set_wallet_policy, en serverbreed IW_READ_ONLY=true. Beide zijn standaard uitgeschakeld.

Alleen hot wallet. Importeer niet je hoofd- of spaarwallet. Iedereen met de keystore en het wrapping-geheim beheert de fondsen; een gelekte seed kan niet worden ingetrokken.

Time-out is geen fout. Pollt get_operation_status / get_swap_status voordat je een verzending of swap opnieuw probeert.

Alle backend-verzoeken gebruiken HTTPS; lokale geheime bestanden gebruiken alleen-eigenaar-rechten (Unix 0600, NTFS ACL op Windows).

Vulnerability disclosure: SECURITY.md.

Testen

Test de server direct met de MCP-inspector. Dit opent een interactieve web-UI waar je tool-aanroepen kunt testen zonder AI-assistent.

npx @modelcontextprotocol/inspector npx -y @ironwallet/mcp-server

Probleemoplossing

De MCP-client geeft een time-out bij de eerste start

npx downloadt het pakket bij de eerste uitvoering, wat ongeveer 30 seconden kan duren.

  • Voer npx -y @ironwallet/mcp-server eenmaal uit in een terminal om de cache op te warmen en maak daarna opnieuw verbinding.
  • Of installeer globaal: npm install -g @ironwallet/mcp-server@latest.

Tools verschijnen niet in de client

  • Controleer of Node.js 20+ is geïnstalleerd: node --version.
  • Herlaad de client na installatie zodat PATH npx bevat.
  • Start na een plugin-installatie (Claude Code / ChatGPT) een nieuwe chat zodat de tools worden geladen.
  • Controleer of het configuratiebestand geldige JSON bevat en herstart de client.
  • Test de server handmatig met de MCP-inspector (zie Testen).

create_wallets retourneert needs_consent

De MCP-disclaimer is nog niet geaccepteerd. Vraag de agent om de volledige disclaimer te tonen en bevestig (accept_mcp_consent), of open de wallet-manager en druk op Doorgaan.

Een overboeking of swap gaf een time-out

Een time-out is geen fout — de transactie kan al zijn uitgezonden. Pollt get_operation_status (overboekingen) of get_swap_status (swaps) voordat je het opnieuw probeert. Dien nooit blindelings opnieuw in.

Een verzending of swap wordt geweigerd

  • Controleer list_wallets → policy: readOnly of een toegestane lijst voor ontvangers kan de operatie blokkeren. { enabled: false } betekent geen limieten.
  • maxPerTxUsd faalt gesloten: als er geen USD-koers beschikbaar is voor het asset, wordt de operatie geweigerd.
  • Controleer of de server draait met IW_READ_ONLY=true.