MCP सेटअप

Cursor, Claude Code, ChatGPT और अन्य MCP क्लाइंट्स के लिए IronWallet MCP सर्वर इंस्टॉल और कॉन्फ़िगर करें।

IronWallet MCP सर्वर (@ironwallet/mcp-server) AI एजेंटों को आपके कंप्यूटर पर एक नॉन-कस्टोडियल क्रिप्टो वॉलेट देता है। सीड वाक्यांश स्थानीय रूप से उत्पन्न और एन्क्रिप्ट किए जाते हैं — वे कभी भी इस मशीन से बाहर नहीं जाते और न ही एजेंट, LLM, या IronWallet बैकएंड के माध्यम से गुजरते हैं। एजेंट बैलेंस चेक कर सकते हैं, डिपॉजिट QR कोड दिखा सकते हैं, टोकन ट्रांसफर कर सकते हैं, और 12 नेटवर्क पर स्वैप कर सकते हैं: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP, और TON।

इसमें प्रति-लेनदेन पुष्टिकरण UI नहीं है — एक बार जब आप एजेंट को भेजने या स्वैप करने के लिए कहते हैं, तो वह दोबारा पूछे बिना हस्ताक्षर और प्रसारण कर सकता है। सीमित बैलेंस वाले एक समर्पित हॉट वॉलेट का उपयोग करें, कभी भी अपने मुख्य वॉलेट का नहीं।

आवश्यकताएँ: Node.js 20+ (npx)। केवल डेस्कटॉप / stdio।

विशेषताएँ

नॉन-कस्टोडियल, स्थानीय हस्ताक्षर

सीड वाक्यांश होस्ट पर एन्क्रिप्टेड रहते हैं (केवल-मालिक फ़ाइल अनुमतियाँ)। लेनदेन इस मशीन पर हस्ताक्षरित होते हैं; कोई भी टूल सीड स्वीकार या रिटर्न नहीं करता है।

स्थानीय ब्राउज़र में वॉलेट

create_wallets के साथ वॉलेट बनाएँ (एक backup_url लौटाता है), या open_wallet_manager के माध्यम से इम्पोर्ट और बैकअप करें — 127.0.0.1 पर केवल लूपबैक पेज जो 15 मिनट की निष्क्रियता के बाद बंद हो जाता है। रहस्य केवल उस ब्राउज़र पेज में दिखाई देते हैं, चैट में कभी नहीं।

शुल्क अनुमान के साथ ट्रांसफर

estimate_transfer प्रसारण के बिना शुल्क का पूर्वावलोकन करता है; send_transfer स्थानीय रूप से हस्ताक्षर करता है और भेजता है; get_operation_status परिणाम पोल करता है। सर्वर राशि को थोड़ा कम कर सकता है ताकि शुल्क बैलेंस में फिट हो सके — प्रतिक्रिया बताती है कि ऐसा कब हुआ।

कैटलॉग-संचालित स्वैप

list_swap_networks और list_swap_assets सेल/बाय कैटलॉग प्रदान करते हैं ताकि एजेंट कभी भी टोकन पते का आविष्कार न करे। estimate_swap कोट करता है, execute_swap एक नए कोट पर निष्पादित करता है, get_swap_status पोल करता है।

डिपॉजिट QR कोड

get_deposit_qr चैट के लिए एक PNG और एक स्थानीय qr_url फॉलबैक लौटाता है।

वैकल्पिक व्यय सीमाएँ

set_wallet_policy के माध्यम से प्रति-वॉलेट नीति: readOnly, maxPerTxUsd, और एक ट्रांसफर प्राप्तकर्ता अनुमति-सूची। डिफ़ॉल्ट रूप से बंद; सेंड और स्वैप दोनों पर लागू होता है। IW_READ_ONLY=true पूरे सर्वर को केवल-पढ़ने योग्य बनाता है।

इंस्टॉलेशन

विकल्प 1: npx (अनुशंसित)

ग्लोबल इंस्टॉलेशन के बिना सर्वर चलाने के लिए npx का उपयोग करें। यह सुनिश्चित करता है कि आप हमेशा नवीनतम संस्करण का उपयोग करें।

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

पहली बार लॉन्च होने में डिपेंडेंसी इंस्टॉल होने के दौरान ~30 सेकंड लग सकते हैं। यदि आपका MCP क्लाइंट टाइम आउट हो जाता है, तो कैश को वार्म करने के लिए टर्मिनल में एक बार कमांड चलाएँ, फिर फिर से कनेक्ट करें।

विकल्प 2: ग्लोबल इंस्टॉल

तेज़ स्टार्टअप के लिए पैकेज को ग्लोबली इंस्टॉल करें, फिर ironwallet-mcp चलाएँ।

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

सेटअप गाइड

केवल डेस्कटॉप के लिए

प्रत्येक क्लाइंट का एक समर्पित स्टेटिक URL है (उदाहरण के लिए /ai/introduction/vscode/)। नीचे दिए गए सभी इंस्टॉल कमांड भी इस पेज पर इनलाइन हैं — कोई टैब नहीं, क्लिक के पीछे कुछ भी छिपा नहीं है।

Cursor

सबसे अधिक अनुशंसित

Cursor में खोलें

एक बार इंस्टॉल करें। उसके बाद, वॉलेट टूल्स हर चैट में उपलब्ध होते हैं। आप इसे ~/.cursor/mcp.json में पेस्ट भी कर सकते हैं और Cursor को रीस्टार्ट कर सकते हैं।

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

इंस्टॉल करने के बाद Cursor को रीलोड करें ताकि PATH में npx शामिल हो सके।

इसके लिए स्टैंडअलोन पेज Cursor — एक HTTP फ़ेच केवल यह गाइड लौटाता है।

Claude Code

Claude Code में खोलें

इन कमांड्स को क्रम में चलाएँ:

1claude plugin marketplace add ironwallet/ironwallet-agent-kit

2claude plugin install ironwallet-mcp@ironwallet

प्लगइन इंस्टॉल करने के बाद, ~45 सेकंड प्रतीक्षा करें और एक नई चैट शुरू करें ताकि टूल्स लोड हो जाएँ।

या Claude Code को सीधे stdio सर्वर पर इंगित करें:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

इसके लिए स्टैंडअलोन पेज Claude Code — एक HTTP फ़ेच केवल यह गाइड लौटाता है।

VS Code

VS Code में खोलें

VS Code खोलता है और स्थानीय MCP सर्वर को रजिस्टर करता है। आप इसे अपनी VS Code MCP सेटिंग्स (यूज़र या वर्कस्पेस) में भी जोड़ सकते हैं।

2 "mcp": {

3 "servers": {

4 "ironwallet": {

5 "type": "stdio",

6 "command": "npx",

7 "args": ["-y", "@ironwallet/mcp-server"]

8 }

9 }

10 }

11}

इसके लिए स्टैंडअलोन पेज VS Code — एक HTTP फ़ेच केवल यह गाइड लौटाता है।

ChatGPT

ChatGPT में खोलें

इन कमांड्स को क्रम में चलाएँ, फिर रीलोड करें ताकि MCP टूल्स उपलब्ध हो जाएँ।

1codex plugin marketplace add ironwallet/ironwallet-agent-kit

2codex plugin add ironwallet-mcp@ironwallet

या ChatGPT को सीधे stdio सर्वर पर इंगित करें:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

इसके लिए स्टैंडअलोन पेज ChatGPT — एक HTTP फ़ेच केवल यह गाइड लौटाता है।

अन्य क्लाइंट्स

stdio ट्रांसपोर्ट का उपयोग करें। अपने MCP क्लाइंट को यहाँ इंगित करें:

2 "mcpServers": {

3 "ironwallet": {

4 "command": "npx",

5 "args": ["-y", "@ironwallet/mcp-server"]

6 }

7 }

इसके लिए स्टैंडअलोन पेज अन्य क्लाइंट्स — एक HTTP फ़ेच केवल यह गाइड लौटाता है।

पहली बार चलाना और वॉलेट सेटअप

इसमें कोई साइन-इन और कोई अकाउंट नहीं है। पहली बार लॉन्च करने पर सर्वर अपने स्थानीय रहस्य उत्पन्न करता है — एक रिले API की, एक कीस्टोर रैपिंग सीक्रेट, और एक डिवाइस आईडी — ~/.ironwallet-mcp/ के तहत केवल-मालिक अनुमतियों के साथ। कॉन्फ़िगर करने के लिए कुछ भी नहीं है।

वॉलेट का उपयोग शुरू करने के लिए:

सहमति. वॉलेट बनाने या इम्पोर्ट करने से पहले, एजेंट चैट में MCP डिस्क्लेमर दिखाता है और आपकी स्वीकृति (accept_mcp_consent) रिकॉर्ड करता है, या आप वॉलेट मैनेजर में जारी रखें (Continue) दबाते हैं।

बनाएँ या इम्पोर्ट करें. create_wallets वॉलेट नाम और पते के साथ एक backup_url लौटाता है — रिकवरी वाक्यांश देखने और बैकअप लेने के लिए इसे अपने ब्राउज़र में खोलें। मौजूदा वॉलेट को इम्पोर्ट करने या बाद में बैकअप बनाने के लिए, open_wallet_manager का उपयोग करें। रिकवरी वाक्यांश केवल स्थानीय ब्राउज़र पेज में टाइप या दिखाया जाता है, चैट में कभी नहीं।

वॉलेट में फंड डालें. एजेंट से डिपॉजिट QR (get_deposit_qr) या पता (list_wallets) मांगें और थोड़ी राशि भेजें। बैलेंस को सीमित रखें — यह एक हॉट वॉलेट है।

डिस्क पर डेटा

सर्वर अपना स्टेट ~/.ironwallet-mcp/ में रखता है (IW_KEYSTORE_DIR के साथ ओवरराइड करें):

आपके वॉलेट सीड के साथ एन्क्रिप्टेड कीस्टोर,

रैपिंग सीक्रेट, रिले API की, और डिवाइस आईडी,

logs/ के तहत डायग्नोस्टिक लॉग (सीड सामग्री कभी लॉग नहीं की जाती)।

चेतावनी: सर्वर को "रीसेट" करने के लिए इस डायरेक्टरी को डिलीट न करें।

इसमें आपके फंड की एन्क्रिप्टेड कुंजियाँ हैं। यदि आप वॉलेट मैनेजर में रिकवरी वाक्यांश का बैकअप लिए बिना इसे हटा देते हैं, तो फंड खो जाएंगे। आपका बैकअप रिकवरी वाक्यांश है, ये फाइलें नहीं।

कीस्टोर और रैपिंग सीक्रेट रखने वाला कोई भी व्यक्ति फंड को नियंत्रित करता है, इसलिए डायरेक्टरी को संवेदनशील मानें।

पर्यावरण चर (Environment variables)

अधिकांश उपयोगकर्ताओं को किसी भी पर्यावरण चर को सेट करने की आवश्यकता नहीं है। सर्वर पहली बार लॉन्च होने पर अपनी ज़रूरत की हर चीज़ उत्पन्न और स्टोर करता है। उन्नत उपयोग के लिए निम्नलिखित उपलब्ध हैं:

चर

विवरण

डिफ़ॉल्ट

IW_READ_ONLY

प्रक्रिया-व्यापी send_transfer और execute_swap को अस्वीकार करें। प्रति-वॉलेट policy.readOnly से अलग

false

IW_KEYSTORE_DIR

कीस्टोर डायरेक्टरी

~/.ironwallet-mcp

IW_PASSPHRASE

कीस्टोर रैपिंग सीक्रेट को ओवरराइड करें

generated locally

IW_RELAY_API_KEY

रिले API की को ओवरराइड करें

generated UUID

IW_HTTP_TIMEOUT_MS

सामान्य HTTP टाइमआउट

15000

IW_HTTP_FORWARD_TIMEOUT_MS

ब्रॉडकास्ट-शैली कॉल के लिए टाइमआउट। क्लाइंट टाइमआउट का मतलब हमेशा यह नहीं है कि ऑपरेशन विफल हो गया — स्थिति की जाँच करें

60000

IW_LOG_ENABLED

लॉग फ़ाइल में JSONL डायग्नोस्टिक्स (0 अक्षम करने के लिए)

IW_LOG_LEVEL

debug / info / warn / error

info

सुरक्षा

सीड कभी भी इस मशीन से बाहर नहीं जाते। वे रेस्ट पर एन्क्रिप्टेड होते हैं और टूल परिणामों, एजेंट चैट, लॉग, या बैकएंड अनुरोधों में कभी दिखाई नहीं देते। कोई भी टूल सीड स्वीकार या रिटर्न नहीं करता है — इम्पोर्ट और बैकअप केवल स्थानीय ब्राउज़र में होते हैं।

एजेंट दोबारा पूछे बिना फंड मूव कर सकता है। इसमें कोई प्रति-लेनदेन पुष्टिकरण UI नहीं है; आपका चैट संदेश ही प्राधिकरण है। ट्रांसफर और स्वैप एक बार प्रसारित होने के बाद अपरिवर्तनीय होते हैं।

वैकल्पिक सीमाएँ। set_wallet_policy के माध्यम से प्रति-वॉलेट नीति (readOnly, maxPerTxUsd, प्राप्तकर्ता अनुमति-सूची), और सर्वर-व्यापी IW_READ_ONLY=true। दोनों डिफ़ॉल्ट रूप से बंद हैं।

केवल हॉट वॉलेट। अपना मुख्य या बचत वॉलेट इम्पोर्ट न करें। कीस्टोर और रैपिंग सीक्रेट रखने वाला कोई भी व्यक्ति फंड को नियंत्रित करता है; लीक हुए सीड को रद्द नहीं किया जा सकता।

टाइमआउट विफलता नहीं है। सेंड या स्वैप को फिर से प्रयास करने से पहले get_operation_status / get_swap_status को पोल करें।

सभी बैकएंड अनुरोध HTTPS का उपयोग करते हैं; स्थानीय गुप्त फाइलें केवल-मालिक अनुमतियों का उपयोग करती हैं (Unix 0600, Windows पर NTFS ACL)।

भेद्यता प्रकटीकरण: SECURITY.md।

परीक्षण

MCP इंस्पेक्टर का उपयोग करके सीधे सर्वर का परीक्षण करें। यह एक इंटरैक्टिव वेब UI खोलता है जहाँ आप AI असिस्टेंट के बिना टूल कॉल का परीक्षण कर सकते हैं।

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

समस्या निवारण

MCP क्लाइंट पहली बार शुरू होने पर टाइम आउट हो जाता है

npx पहली बार चलने पर पैकेज डाउनलोड करता है, जिसमें ~30 सेकंड लग सकते हैं।

कैश को वार्म करने के लिए टर्मिनल में एक बार npx -y @ironwallet/mcp-server चलाएँ, फिर फिर से कनेक्ट करें।
या ग्लोबली इंस्टॉल करें: npm install -g @ironwallet/mcp-server@latest।

टूल्स क्लाइंट में दिखाई नहीं देते

जाँचें कि Node.js 20+ इंस्टॉल है: node --version।
इंस्टॉल करने के बाद क्लाइंट को रीलोड करें ताकि PATH में npx शामिल हो सके।
प्लगइन इंस्टॉल करने के बाद (Claude Code / ChatGPT), एक नई चैट शुरू करें ताकि टूल्स लोड हो जाएँ।
सत्यापित करें कि कॉन्फ़िगरेशन फ़ाइल में वैध JSON है और क्लाइंट को रीस्टार्ट करें।
MCP इंस्पेक्टर के साथ सर्वर का मैन्युअल रूप से परीक्षण करें (परीक्षण देखें)।

`create_wallets` `needs_consent` लौटाता है

MCP डिस्क्लेमर अभी तक स्वीकार नहीं किया गया है। एजेंट से पूरा डिस्क्लेमर दिखाने और पुष्टि करने (accept_mcp_consent) के लिए कहें, या वॉलेट मैनेजर खोलें और जारी रखें (Continue) दबाएँ।

ट्रांसफर या स्वैप टाइम आउट हो गया

टाइमआउट विफलता नहीं है — लेनदेन पहले ही प्रसारित हो चुका हो सकता है। फिर से प्रयास करने से पहले get_operation_status (ट्रांसफर) या get_swap_status (स्वैप) को पोल करें। कभी भी आँख बंद करके दोबारा सबमिट न करें।

सेंड या स्वैप अस्वीकार कर दिया गया

list_wallets → policy की जाँच करें: readOnly या प्राप्तकर्ता अनुमति-सूची ऑपरेशन को ब्लॉक कर सकती है। { enabled: false } का मतलब है कोई सीमा नहीं।
maxPerTxUsd विफल हो जाता है: यदि एसेट के लिए कोई USD दर उपलब्ध नहीं है, तो ऑपरेशन अस्वीकार कर दिया जाता है।
जाँचें कि क्या सर्वर IW_READ_ONLY=true के साथ चल रहा है।

MCP सेटअप

विशेषताएँ

इंस्टॉलेशन

सेटअप गाइड

Cursor

Claude Code

VS Code

ChatGPT

अन्य क्लाइंट्स

पहली बार चलाना और वॉलेट सेटअप

डिस्क पर डेटा

पर्यावरण चर (Environment variables)

सुरक्षा

परीक्षण

समस्या निवारण

MCP क्लाइंट पहली बार शुरू होने पर टाइम आउट हो जाता है

टूल्स क्लाइंट में दिखाई नहीं देते

create_wallets needs_consent लौटाता है

ट्रांसफर या स्वैप टाइम आउट हो गया

सेंड या स्वैप अस्वीकार कर दिया गया

संबंधित

`create_wallets` `needs_consent` लौटाता है