ప్రధాన కంటెంట్‌కు దాటవేయండి
MCP SERVER

ఏ MCP క్లయింట్‌కైనా ఏజెంట్ వాలెట్ టూల్స్.

Official Blockchain0x MCP server ఒక MCP-aware agent కు wallets చదవడం, Base పై USDC పంపడం, మరియు invoices settle చేయడం వంటి సామర్థ్యాన్ని ఇస్తుంది. Hosted endpoint ను connect చేయండి, లేదా ఒకే command తో local గా run చేయండి.

https://mcp.blockchain0x.com/mcp
ఇది ఏమిటి

ఒక server. ఐదు tools. ప్రతి MCP client.

Model Context Protocol అనేది AI clients - Claude Desktop, Cursor, Cline, మరియు ఇతరులు - external tools ను పిలవడానికి ఉపయోగించే standard మార్గం. Blockchain0x MCP server మీ agent wallets ను ఆ standard ద్వారా expose చేస్తుంది, కాబట్టి custom integration రాయకుండానే ఏ MCP client అయినా డబ్బును move చేయగలదు.

ఈ server, Blockchain0x API పై ఒక thin, stateless proxy. ఇది ఎలాంటి funds లేదా database ను hold చేయదు; మీరు ఇచ్చిన key ను ఉపయోగించి ప్రతి tool call ను API కి forward చేస్తుంది, మరియు ప్రతి agent పై ఉన్న spend permission ఇప్పటికీ ఒక tool ఏమి చేయగలదో పరిమితం చేస్తుంది.

THE TOOLS

ఏజెంట్ ఏమి call చేయగలదో.

get_wallet

ఒక ఏజెంట్ యొక్క wallet ను చదవండి: address, Base పై USDC balance, మరియు metadata.

list_wallets

మీ workspace లోని ఏజెంట్ వాలెట్లను జాబితా చేయండి.

get_transaction

దాని id ద్వారా ఒక లావాదేవీని వెతికి, దాని on-chain స్థితిని చదవండి.

send_payment

Base పై ఉన్న ఏజెంట్ wallet నుండి, దాని spend permission లోపల USDC పంపండి.

settle_payment_request

Dashboard లో మీరు సృష్టించిన payment request ను on-chain proof తో settle చేయండి.

ఎలా ఉపయోగించాలి

Connect చేయడానికి రెండు మార్గాలు.

1. హోస్టెడ్ (Streamable HTTP)

మీ MCP క్లయింట్‌ను హోస్టెడ్ ఎండ్‌పాయింట్‌కు కనెక్ట్ చేసి, మీ API key ను Bearer header గా పంపండి. ఇన్‌స్టాల్ చేయాల్సింది ఏమీ లేదు.

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

2. లోకల్ (stdio, 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 కు ధర పెట్టడానికి, MCP integration recipe చూడండి.

భద్రత

Spend permission ఇంకా వర్తిస్తుంది.

  • ఈ server మీ funds ను లేదా మీ keys ను ఎప్పుడూ hold చేయదు; ప్రతి call ను Blockchain0x API కి forward చేస్తుంది.
  • send_payment settle కావడానికి ముందు, agent యొక్క per-transaction cap మరియు per-period allowance తో తనిఖీ చేయబడుతుంది, ఇతర ఏ API call లాగానే.
  • Wallets మరియు transactions మాత్రమే చదవాల్సిన ఏజెంట్ కోసం read-only key (pay scope లేదు) ను ఉపయోగించండి.
  • stdio లో, key మీ local environment లోనే ఉంటుంది. hosted లో, అది TLS మీద Bearer header గా పంపబడుతుంది మరియు నిల్వ చేయబడదు.
సాధారణంగా అడిగే

MCP server గురించి మూడు ప్రశ్నలు.

MCP server ఎక్కడ run అవుతుంది, మరియు మీరు నా key ను చూస్తారా?

దీన్ని run చేయడానికి రెండు మార్గాలు. Hosted: మీ MCP client ను Streamable HTTP endpoint కు connect చేసి, ప్రతి request లో మీ API key ను Bearer header గా పంపండి; ఈ server Blockchain0x API కి calls ను forward చేసే ఒక stateless proxy. Local (stdio): npx @blockchain0x/mcp ను మీ own machine పై run చేయండి, అప్పుడు మీ key మీ environment లోనే ఉంటుంది, మీ device ను ఎప్పుడూ వదిలి వెళ్లదు. Hosted endpoint కు key పంపకూడదనుకుంటే stdio ను ఎంచుకోండి.

ఏ API key ను నేను ఉపయోగించాలి?

ఒక sk_test_ key Base Sepolia (testnet) పై నడుస్తుంది కాబట్టి నిజమైన డబ్బును కదపకుండా 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 తో ఒకటేనా?

లేదు. ఈ పేజీ Blockchain0x MCP server గురించి, ఇది ఒక MCP client‌కు agent wallet tools (wallets చదవడం, USDC పంపడం, invoices settle చేయడం) అందిస్తుంది. requirePayment అనేది @blockchain0x/mcp లోని ఒక వేరే helper, దీన్ని మీరు x402 402 challenge ని తిరిగి ఇచ్చి మీ సొంత MCP tools కి ధర నిర్ణయించడానికి ఉపయోగిస్తారు. దానికి సంబంధించిన MCP integration recipe చూడండి.

మీ MCP క్లయింట్‌కు ఒక వాలెట్ ఇవ్వండి.

ఒక ఏజెంట్ వాలెట్ సృష్టించండి, ఒక కీ తీసుకోండి, మరియు మీ క్లయింట్‌ను సర్వర్‌కు సూచించండి. ప్రారంభించడం ఉచితం.