मुख्य सामग्री पर जाएं
MCP SERVER

किसी भी MCP client के लिए agent wallet tools.

आधिकारिक Blockchain0x MCP server एक MCP-aware agent को wallets पढ़ने, Base पर USDC भेजने, और invoices settle करने की क्षमता देता है। hosted endpoint से connect करें, या इसे एक command से locally चलाएं।

https://mcp.blockchain0x.com/mcp
यह क्या है

एक server. पाँच tools. हर MCP client.

Model Context Protocol वह standard तरीका है जिससे AI clients - Claude Desktop, Cursor, Cline, और अन्य - external tools call करते हैं। Blockchain0x MCP server आपके agent wallets को उसी standard के जरिए expose करता है, ताकि कोई भी MCP client बिना custom integration लिखे पैसे move कर सके।

यह server Blockchain0x API पर एक thin, stateless proxy है। यह न funds रखता है और न database; यह आपके द्वारा दी गई key का उपयोग करके हर tool call को API तक forward करता है, और हर agent पर spend permission अभी भी सीमित करती है कि कोई tool क्या कर सकता है।

TOOLS

Agent क्या call कर सकता है।

get_wallet

एक agent के wallet को पढ़ें: address, Base पर USDC balance, और metadata।

list_wallets

अपने workspace में agent wallets की सूची देखें।

get_transaction

किसी transaction को उसके id से देखें और उसका on-chain status पढ़ें।

send_payment

Base पर किसी agent के wallet से, उसकी spend permission के भीतर USDC भेजें।

settle_payment_request

Dashboard में आपने जो payment request बनाई है, उसे on-chain proof के साथ settle करें।

इसे कैसे उपयोग करें

Connect करने के दो तरीके।

1. होस्टेड (Streamable HTTP)

अपने MCP client को hosted endpoint पर point करें और अपनी API key को Bearer header के रूप में pass करें। कुछ install करने की जरूरत नहीं।

MCP CLIENT CONFIG (HOSTED)
{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

2. लोकल (stdio, via npx)

npx @blockchain0x/mcp के साथ server को अपनी machine पर चलाएं। आपकी key आपके environment में रहती है और कभी आपके device से बाहर नहीं जाती।

MCP CLIENT CONFIG (STDIO)
{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["@blockchain0x/mcp"],
      "env": { "BLOCKCHAIN0X_API_KEY": "sk_live_..." }
    }
  }
}

Base Sepolia के साथ एक sk_test_ key से शुरू करें, फिर sk_live_ पर switch करें। पूरा setup the docs में है; अपने MCP tools की price तय करने के लिए MCP integration recipe देखें।

सुरक्षा

Spend permission फिर भी लागू रहती है।

  • यह server कभी आपके funds या keys नहीं रखता; यह हर call को Blockchain0x API तक forward करता है।
  • send_payment को settle होने से पहले agent की per-transaction cap और per-period allowance के against check किया जाता है, ठीक किसी भी अन्य API call की तरह।
  • ऐसे agent के लिए read-only key (no pay scope) का उपयोग करें जिसे केवल wallets और transactions पढ़ने हैं।
  • stdio पर key आपके local environment में रहती है। hosted पर, यह TLS के जरिए Bearer header के रूप में जाती है और store नहीं होती।
अक्सर पूछे जाने वाले

MCP server से जुड़े तीन सवाल।

MCP server कहाँ चलता है, और क्या आप मेरी key देख सकते हैं?

इसे चलाने के दो तरीके हैं। Hosted: अपने MCP client को Streamable HTTP endpoint से connect करें और हर request पर अपनी API key को Bearer header के रूप में भेजें; server एक stateless proxy है जो calls को Blockchain0x API तक forward करता है। Local (stdio): अपने own machine पर npx @blockchain0x/mcp चलाएं और आपकी key आपके environment में ही रहती है, कभी आपके device से बाहर नहीं जाती। अगर आप key को hosted endpoint पर नहीं भेजना चाहते, तो stdio चुनें।

मुझे कौन सी API key इस्तेमाल करनी चाहिए?

एक sk_test_ key Base Sepolia (testnet) पर चलता है, ताकि आप real money भेजे बिना tools को wire up कर सकें; mainnet के लिए sk_live_ key पर switch करें। key के scopes तय करते हैं कि tools क्या कर सकते हैं - एक read-only key get_wallet, list_wallets, और get_transaction call कर सकता है, लेकिन send_payment नहीं।

क्या यह requirePayment helper के समान है?

नहीं। यह page Blockchain0x MCP server के बारे में है, जो एक MCP client को agent wallet tools देता है (wallets पढ़ना, USDC भेजना, invoices settle करना)। requirePayment @blockchain0x/mcp में एक अलग helper है, जिसका उपयोग आप अपने OWN MCP tools की price तय करने के लिए करते हैं, x402 402 challenge return करके। इसके लिए MCP integration recipe देखें।

अपने MCP client को एक wallet दें।

एक agent wallet बनाएं, एक key लें, और अपने client को server पर point करें। शुरू करने के लिए free.