মূল বিষয়বস্তুতে যান
MCP SERVER

যে কোনও MCP client-এর জন্য agent wallet tools.

official Blockchain0x MCP server একটি MCP-aware agent-কে wallets read করা, Base-এ USDC send করা, এবং invoices settle করার ক্ষমতা দেয়। hosted endpoint-এ connect করুন, অথবা এক command-এ localভাবে run করুন।

https://mcp.blockchain0x.com/mcp
এটি কী

একটি server। পাঁচটি tool। প্রতিটি MCP client।

Model Context Protocol হলো external tools call করার standard উপায়, যা AI clients - Claude Desktop, Cursor, Cline, এবং others - ব্যবহার করে। Blockchain0x MCP server সেই standard-এর মাধ্যমে আপনার agent wallets expose করে, তাই কোনও MCP client-ই custom integration না লিখে money 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

এর id দিয়ে একটি transaction খুঁজে বের করুন এবং এর on-chain status পড়ুন।

send_payment

Base-এ একটি agent-এর wallet থেকে USDC send করুন, এর spend permission-এর মধ্যে থেকে।

settle_payment_request

dashboard-এ তৈরি করা একটি payment request on-chain proof সহ settle করুন।

কীভাবে ব্যবহার করবেন

connect করার দুইটি উপায়।

1. Hosted (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. Local (stdio, via npx)

npx @blockchain0x/mcp দিয়ে server-টি আপনার নিজের machine-এ run করুন। আপনার 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 সেটেল হওয়ার আগে এজেন্টের per-transaction cap এবং per-period allowance-এর বিপরীতে যাচাই করা হয়, অন্যান্য যেকোনো API call-এর মতোই।
  • যে agent শুধু wallets এবং transactions read করবে, তার জন্য read-only key (no pay scope) ব্যবহার করুন।
  • stdio-তে, key আপনার local environment-এ থাকে। hosted-এ, এটি TLS-এর মাধ্যমে Bearer header হিসেবে যায় এবং store করা হয় না।
প্রায়শই জিজ্ঞাসিত

MCP server সম্পর্কে তিনটি প্রশ্ন।

MCP server কোথায় run হয়, এবং আপনি কি আমার key দেখতে পান?

এটি run করার দুইটি উপায়। Hosted: আপনার MCP client-কে Streamable HTTP endpoint-এর সাথে connect করুন এবং প্রতিটি request-এ আপনার API key Bearer header হিসেবে send করুন; server-টি একটি stateless proxy যা call গুলো Blockchain0x API-তে forward করে। Local (stdio): আপনার নিজের machine-এ npx @blockchain0x/mcp run করুন এবং আপনার key আপনার environment-এ থাকে, কখনও আপনার device ছাড়ে না। যদি আপনি key hosted endpoint-এ send না করতে চান, তাহলে stdio বেছে নিন।

আমি কোন API key ব্যবহার করব?

একটি sk_test_ key Base Sepolia (testnet)-এ চলে, তাই আপনি real money না সরিয়েই tools সেটআপ করতে পারেন; 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 দেয় (wallet read করা, USDC send করা, invoice settle করা)। requirePayment হলো @blockchain0x/mcp-এর একটি separate helper, যা আপনি আপনার OWN MCP tools-এর জন্য x402 402 challenge return করে price নির্ধারণ করতে ব্যবহার করেন। এর জন্য MCP integration recipe দেখুন।

আপনার MCP client-কে একটি wallet দিন।

একটি agent wallet তৈরি করুন, একটি key নিন, এবং আপনার client-কে server-এর দিকে point করুন। শুরু করা free।