Salta al contenuto principale
SERVER MCP

Strumenti wallet agent per qualsiasi client MCP.

Il server MCP ufficiale di Blockchain0x dà a un agente compatibile con MCP la possibilità di leggere wallet, inviare USDC su Base e saldare fatture. Connettiti all'endpoint hosted oppure eseguilo in locale con un solo comando.

https://mcp.blockchain0x.com/mcp
COS'È

Un server. Cinque strumenti. Ogni client MCP.

Il Model Context Protocol è il modo standard con cui i client AI - Claude Desktop, Cursor, Cline e altri - chiamano strumenti esterni. Il server MCP di Blockchain0x espone i wallet dei tuoi agenti tramite questo standard, così qualsiasi client MCP può movimentare denaro senza che tu debba scrivere un'integrazione personalizzata.

Il server è un proxy leggero e stateless sopra la Blockchain0x API. Non detiene fondi né un database; inoltra ogni chiamata dello strumento all'API usando la chiave che fornisci, e il permesso di spesa di ciascun agente continua a delimitare ciò che uno strumento può fare.

GLI STRUMENTI

Ciò che l'agente può chiamare.

get_wallet

Leggi il wallet di un agente: indirizzo, saldo USDC su Base e metadati.

list_wallets

Elenca i wallet degli agenti nel tuo workspace.

get_transaction

Cerca una transazione in base al suo id e leggi il suo stato on-chain.

send_payment

Invia USDC dal wallet di un agente su Base, entro il suo permesso di spesa.

settle_payment_request

Rendi definitivo un payment request che hai creato nella dashboard, con prova on-chain.

COME USARLO

Due modi per connettersi.

1. Ospitato (Streamable HTTP)

Punta il tuo client MCP verso l'endpoint hosted e passa la tua API key come header Bearer. Niente da installare.

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

2. Locale (stdio, tramite npx)

Esegui il server sulla tua macchina con npx @blockchain0x/mcp. La tua chiave rimane nel tuo ambiente e non lascia mai il dispositivo.

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

Inizia con una chiave sk_test_ su Base Sepolia, poi passa a sk_live_. La configurazione completa è nella sezione docs; per applicare un prezzo ai tuoi strumenti MCP, consulta la guida di integrazione MCP.

SICUREZZA

Il permesso di spesa continua ad applicarsi.

  • Il server non detiene mai i tuoi fondi né le tue chiavi; inoltra ogni chiamata alla Blockchain0x API.
  • send_payment viene verificato rispetto al limite per transazione e all'allowance per periodo dell'agente prima della liquidazione, come qualsiasi altra chiamata API.
  • Usa una chiave in sola lettura (senza scope pay) per un agente che deve solo leggere wallet e transazioni.
  • Con stdio, la chiave resta nel tuo ambiente locale. Con hosted, viaggia come header Bearer su TLS e non viene memorizzata.
DOMANDE FREQUENTI

Tre domande sul server MCP.

Dove viene eseguito il server MCP e puoi vedere la mia chiave?

Due modi per eseguirlo. Hosted: collega il tuo client MCP all'endpoint Streamable HTTP e invia la tua API key come header Bearer in ogni richiesta; il server è un proxy stateless che inoltra le chiamate alla Blockchain0x API. Locale (stdio): esegui npx @blockchain0x/mcp sulla tua macchina e la tua chiave rimane nel tuo ambiente, senza lasciare mai il dispositivo. Scegli stdio se preferisci non inviare la chiave a un endpoint hosted.

Quale API key dovrei usare?

Una chiave sk_test_ funziona su Base Sepolia (testnet), così puoi configurare gli strumenti senza movimentare denaro reale; passa a una chiave sk_live_ per la mainnet. Gli scope della chiave decidono cosa possono fare gli strumenti - una chiave in sola lettura può chiamare get_wallet, list_wallets e get_transaction ma non send_payment.

È la stessa cosa dell'helper requirePayment?

No. Questa pagina riguarda il server MCP di Blockchain0x, che fornisce a un client MCP strumenti wallet per agenti (leggere wallet, inviare USDC, saldare fatture). requirePayment è un helper separato in @blockchain0x/mcp che usi per assegnare un prezzo ai TUOI strumenti MCP restituendo una sfida x402 402. Consulta la ricetta di integrazione MCP per questo.

Dai un wallet al tuo client MCP.

Crea un wallet agent, recupera una chiave e punta il tuo client al server. Inizia gratis.