ਮੁੱਖ ਸਮੱਗਰੀ 'ਤੇ ਜਾਓ
MCP SERVER

ਕਿਸੇ ਵੀ MCP client ਲਈ agent wallet tools.

Official Blockchain0x MCP server ਇੱਕ MCP-aware agent ਨੂੰ wallets ਪੜ੍ਹਨ, Base 'ਤੇ USDC ਭੇਜਣ, ਅਤੇ invoices settle ਕਰਨ ਦੀ power ਦਿੰਦਾ ਹੈ। Hosted endpoint ਨਾਲ connect ਕਰੋ, ਜਾਂ ਇੱਕ command ਨਾਲ ਇਸਨੂੰ local ਤੌਰ 'ਤੇ ਚਲਾਓ।

https://mcp.blockchain0x.com/mcp
ਇਹ ਕੀ ਹੈ

ਇੱਕ server। ਪੰਜ tools। ਹਰ MCP client।

Model Context Protocol AI clients - Claude Desktop, Cursor, Cline, ਅਤੇ ਹੋਰਾਂ - ਲਈ external tools call ਕਰਨ ਦਾ standard ਤਰੀਕਾ ਹੈ। Blockchain0x MCP server ਤੁਹਾਡੇ agent wallets ਨੂੰ ਉਸੀ standard ਰਾਹੀਂ expose ਕਰਦਾ ਹੈ, ਤਾਂ ਜੋ ਕੋਈ ਵੀ MCP client custom integration ਲਿਖੇ ਬਿਨਾਂ money move ਕਰ ਸਕੇ।

Server Blockchain0x API ਉੱਤੇ ਇੱਕ thin, stateless proxy ਹੈ। ਇਹ ਨਾ funds ਰੱਖਦਾ ਹੈ ਅਤੇ ਨਾ ਹੀ database; ਇਹ ਤੁਹਾਡੀ ਦਿੱਤੀ key ਵਰਤ ਕੇ ਹਰ tool call API ਨੂੰ forward ਕਰਦਾ ਹੈ, ਅਤੇ ਹਰ agent ਦੀ spend permission ਫਿਰ ਵੀ ਇਹ ਸੀਮਿਤ ਕਰਦੀ ਹੈ ਕਿ tool ਕੀ ਕਰ ਸਕਦਾ ਹੈ।

ਟੂਲਜ਼

ਏਜੰਟ ਕੀ call ਕਰ ਸਕਦਾ ਹੈ।

get_wallet

ਇੱਕ ਏਜੰਟ ਵਾਲਿਟ ਪੜ੍ਹੋ: address, Base 'ਤੇ USDC balance, ਅਤੇ metadata।

list_wallets

ਆਪਣੇ workspace ਵਿੱਚ agent wallets ਦੀ ਸੂਚੀ ਦਿਖਾਓ।

get_transaction

ਇੱਕ transaction ਨੂੰ ਉਸਦੇ id ਨਾਲ look up ਕਰੋ ਅਤੇ ਉਸਦੀ on-chain status ਪੜ੍ਹੋ।

send_payment

Base 'ਤੇ agent ਦੇ wallet ਤੋਂ USDC ਭੇਜੋ, ਉਸਦੀ spend permission ਦੇ ਅੰਦਰ।

settle_payment_request

Dashboard ਵਿੱਚ ਬਣਾਈ payment request ਨੂੰ on-chain proof ਨਾਲ settle ਕਰੋ।

ਇਹ ਕਿਵੇਂ ਵਰਤਣਾ ਹੈ

ਕਨੈਕਟ ਕਰਨ ਦੇ ਦੋ ਤਰੀਕੇ।

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 ਆਪਣੀ ਮਸ਼ੀਨ 'ਤੇ ਚਲਾਓ। ਤੁਹਾਡੀ 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 ਦੇ ਖ਼ਿਲਾਫ਼ 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): ਆਪਣੀ machine 'ਤੇ npx @blockchain0x/mcp ਚਲਾਓ ਅਤੇ ਤੁਹਾਡੀ key ਤੁਹਾਡੇ environment ਵਿੱਚ ਹੀ ਰਹੇਗੀ, ਕਦੇ ਵੀ ਤੁਹਾਡੇ device ਤੋਂ ਬਾਹਰ ਨਹੀਂ ਜਾਵੇਗੀ। ਜੇ ਤੁਸੀਂ key ਨੂੰ hosted endpoint ਨੂੰ ਨਹੀਂ ਭੇਜਣਾ ਚਾਹੁੰਦੇ, ਤਾਂ stdio ਚੁਣੋ।

ਮੈਂ ਕਿਹੜੀ API key ਵਰਤਾਂ?

ਇੱਕ sk_test_ key Base Sepolia (testnet) 'ਤੇ ਚੱਲਦਾ ਹੈ ਤਾਂ ਜੋ ਤੁਸੀਂ real money moved ਕੀਤੇ ਬਿਨਾਂ 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 read ਕਰੋ, USDC send ਕਰੋ, invoices settle ਕਰੋ)। requirePayment @blockchain0x/mcp ਵਿੱਚ ਇੱਕ ਵੱਖਰਾ helper ਹੈ ਜਿਸਦਾ ਇਸਤੇਮਾਲ ਤੁਸੀਂ ਆਪਣੇ OWN MCP tools 'ਤੇ price ਲਗਾਉਣ ਲਈ ਕਰਦੇ ਹੋ, ਇੱਕ x402 402 challenge ਵਾਪਸ ਕਰਕੇ। ਇਸ ਲਈ MCP integration recipe ਵੇਖੋ।

ਆਪਣੇ MCP client ਨੂੰ ਇੱਕ wallet ਦਿਓ।

ਇੱਕ agent wallet ਬਣਾਓ, ਇੱਕ key ਲਵੋ, ਅਤੇ ਆਪਣੇ client ਨੂੰ server ਵੱਲ point ਕਰੋ। ਸ਼ੁਰੂ ਕਰਨ ਲਈ ਮੁਫ਼ਤ।