Model Context Protocol
Codici QR crypto, nella lingua che la Sua IA parla già.
Colleghi Toreador a Claude Desktop, Cursor, Windsurf o a qualsiasi assistente compatibile con MCP in 30 secondi. Poi basta chiedere: «genera un codice QR Bitcoin per 0.001 BTC verso bc1q…». L'assistente chiama Toreador, riceve il QR e glielo mostra.
Configurazione in 30 secondi
Ogni strumento richiede una chiave API, inclusa in ogni piano, compreso il piano gratuito. Non esiste un accesso anonimo.
tor_test_
Chiave di test (sandbox)
Una chiave tor_test_… esegue ogni strumento sulle reti di test (Sepolia, Polygon Amoy, Base Sepolia, Solana Devnet), fuori da qualsiasi quota. Ideale per provare l'integrazione senza fondi reali.
tor_live_ · Consigliato
Chiave di produzione (mainnet)
Una chiave tor_live_… genera richieste di pagamento reali sulla mainnet. La frequenza al minuto e la quota mensile di pagamenti tracciati dipendono dal Suo piano.
Generi le Sue chiavi API nella Sua dashboard.
Strumenti esposti
Il server MCP espone i seguenti strumenti. Tutti richiedono una chiave API.
| Strumento | Descrizione |
|---|---|
toreador_create_checkout |
Creare una richiesta di pagamento in USD o in EUR e ottenere il link della relativa pagina di pagamento ospitata, dove il pagatore sceglie la stablecoin e la rete. Lo strumento principale per farsi pagare. |
toreador_get_payment |
Consultare un pagamento tramite il suo id di checkout o di sessione: stato, token, rete, importo, hash della transazione e cronologia. |
toreador_list_payments |
Elencare i pagamenti tracciati recenti di tutto il team, dal più recente, con stato, importi, hash della transazione, riferimento e punto vendita. Paginato; può essere limitato a un solo punto vendita. |
toreador_list_wallets |
Elencare i wallet di ricezione registrati nell'account. Un pagamento può andare solo verso uno di essi. |
toreador_list_establishments |
Elencare i punti vendita dell'organizzazione. Un id limita l'elenco dei pagamenti a un punto vendita, oppure vi associa una nuova richiesta di pagamento. |
toreador_list_tokens |
Elencare le coppie token e rete pagabili nell'ambiente della chiave (produzione o test). |
toreador_get_account |
Consultare l'account della chiave: piano, ambiente, quota mensile utilizzata e residua. |
toreador_generate_qr |
Generare un codice QR diretto per una criptovaluta nativa (BTC, ETH, SOL, POL e altre) o un token su Solana, come immagine o come testo per un terminale. Il pagamento non è tracciato. |
toreador_create_session |
Avanzato: creare un pagamento tracciato in una determinata stablecoin su una determinata rete, ad esempio esattamente 100 USDC su Base, con la relativa pagina di pagamento ospitata. |
toreador_screen_address |
Verificare un indirizzo rispetto alle liste di sanzioni: pulito, sanzionato o sconosciuto. |
Host compatibili
Qualsiasi client compatibile con MCP. Stessa configurazione JSON ovunque: cambia solo la posizione del file.
Claude Desktop
Modifichi ~/Library/Application Support/Claude/claude_desktop_config.json e aggiunga lo snippet qui sotto. Riavvii l'app — Toreador compare nel pannello degli strumenti.
Cursor
Settings → MCP → New MCP server. Incolli lo stesso JSON, con ambito di progetto o globale.
Windsurf
Settings → Cascade → MCP Servers → Edit JSON. Stessa configurazione.
Other MCP-capable hosts
Qualsiasi client che parli Model Context Protocol tramite stdio può avviare il server con npx -y @toreador/mcp-server.
Perché MCP anziché l'API REST?
MCP e l'API REST si rivolgono a pubblici diversi. Usi l'API REST quando scrive codice backend che richiede un comportamento deterministico: pagine di checkout, cron job, sincronizzazione dello stato degli ordini. Usi il server MCP quando una persona (o un agente IA per suo conto) vuole generare un QR al momento, in conversazione, senza scrivere codice.
Lo stesso backend alimenta entrambi. Tutto ciò che può fare tramite MCP, può farlo anche tramite REST. Il server MCP è solo un sottile adattatore stdio che traduce le chiamate agli strumenti del Suo assistente in chiamate HTTPS all'API di Toreador.
Pronto a lasciare che la Sua IA crei richieste di pagamento crypto?
Inizi gratis, senza carta. Ogni piano include l'API e l'SDK; passi a un piano superiore dalla Sua dashboard quando le serve una quota maggiore di pagamenti tracciati.