convez.ai
MCP ServerIntegração & APIsAvançado
plagtech

Spraay x402 MCP Server

plagtech/spraay-x402-mcp

57 ferramentas DeFi pay-per-use para agentes de IA na Base

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que conecta agentes de IA (Claude, Cursor) a uma infraestrutura DeFi completa na rede Base. Oferece 57 ferramentas pay-per-use para pagamentos onchain, swaps, dados de oráculos, payroll, faturas, escrow, armazenamento IPFS, KYC e acesso a 200+ modelos de IA, com cobrança automática em USDC via protocolo x402.

Instalação

$npx convez-ai plagtech/spraay-x402-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de pagamentos em lote para funcionários ou fornecedores em stablecoins
  • Consultas de preços onchain e dados de oráculos com confiança verificada
  • Swaps de tokens e pontes cross-chain sem chaves de API
  • Geração de faturas persistentes com rastreamento de pagamentos
  • Acesso a 200+ modelos de IA (GPT-4, Claude, Llama, Gemini) via agentes

Veredito

Solução robusta para agentes de IA que precisam operar autonomamente em DeFi sem gerenciar chaves de API. Modelo pay-per-use diminui fricção, mas exige conta Base com USDC e compreensão de sistemas onchain. Ideal para automação financeira e pagamentos em escala.

README

A tradução para o português deste README ainda está na fila.

Spraay x402 MCP Server

smithery badge Version Tools License: MIT

Full-stack DeFi infrastructure for AI agents — 57 pay-per-use tools (56 active) on Base with persistent Supabase storage.

Connect Claude, Cursor, or any MCP-compatible AI to onchain payments, token swaps, bridge, payroll, invoicing, escrow, oracle data, analytics, AI inference, email, XMTP messaging, webhooks, cron scheduling, IPFS storage, multi-chain RPC, KYC, auth, audit trail, tax & 200+ AI models.

AI agents pay USDC per request via x402 protocol. No API keys. No accounts. Just plug in and go.


Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "spraay": {
      "command": "npx",
      "args": ["-y", "spraay-x402-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "spraay": {
      "command": "npx",
      "args": ["-y", "spraay-x402-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Smithery

smithery mcp add Plagtech/Spraay-x402-mcp

From Source

git clone https://github.com/plagtech/spraay-x402-mcp
cd spraay-x402-mcp
npm install
echo "EVM_PRIVATE_KEY=0xYOUR_KEY" > .env
npm start

57 Tools — 15 Categories

AI ($0.001–$0.005)

ToolDescriptionCost
spraay_chatChat with 200+ AI models (GPT-4, Claude, Llama, Gemini)$0.005
spraay_modelsList all available models$0.001

Payments ($0.001–$0.01)

ToolDescriptionCost
spraay_batch_executeBatch pay up to 200 recipients in one tx$0.01
spraay_batch_estimateEstimate gas for batch payment$0.001

DeFi — Swap ($0.001–$0.01)

ToolDescriptionCost
spraay_swap_quoteGet Uniswap V3 swap quote$0.002
spraay_swap_tokensList supported swap tokens$0.001
spraay_swap_executeExecute swap (unsigned tx)$0.01

Oracle ($0.001–$0.003)

ToolDescriptionCost
spraay_oracle_pricesOn-chain token prices with confidence scores$0.003
spraay_oracle_gasGas prices on Base$0.001
spraay_oracle_fxStablecoin FX rates with depeg detection$0.002

Bridge ($0.001–$0.005)

ToolDescriptionCost
spraay_bridge_quoteCross-chain bridge quote (8+ chains)$0.005
spraay_bridge_chainsSupported bridge chains$0.001

Payroll ($0.001–$0.02)

ToolDescriptionCost
spraay_payroll_executePay up to 200 employees in stablecoins$0.02
spraay_payroll_estimateEstimate payroll gas and fees$0.002
spraay_payroll_tokensList payroll stablecoins$0.001

Invoice ($0.001–$0.005) — persistent

ToolDescriptionCost
spraay_invoice_createCreate invoice with payment tx$0.005
spraay_invoice_listList invoices by address$0.002
spraay_invoice_getLook up invoice by ID$0.001

Analytics ($0.003–$0.005)

ToolDescriptionCost
spraay_analytics_walletWallet profile: balances, age, classification$0.005
spraay_analytics_txhistoryTransaction history with decoded types$0.003

Escrow ($0.001–$0.008) — persistent

ToolDescriptionCost
spraay_escrow_createCreate conditional escrow with milestones$0.008
spraay_escrow_listList escrows by address$0.002
spraay_escrow_getEscrow status and details$0.001
spraay_escrow_fundMark escrow as funded$0.002
spraay_escrow_releaseRelease funds to beneficiary$0.005
spraay_escrow_cancelCancel escrow$0.002

AI Inference ($0.008–$0.01)

ToolDescriptionCost
spraay_classify_addressAI wallet classification with risk scoring$0.008
spraay_classify_txAI transaction classification and risk analysis$0.008
spraay_explain_contractAI smart contract analysis and explanation$0.01
spraay_summarizeAI intelligence briefing for any address or tx$0.008

Communication ($0.001–$0.005)

ToolDescriptionCostStatus
spraay_notify_emailSend email notifications (AgentMail)$0.003✅ Live
spraay_notify_smsSend SMS notifications$0.005⏳ Simulated
spraay_notify_statusCheck notification delivery status$0.001✅ Live
spraay_webhook_registerRegister webhook endpoint$0.003✅ Persistent
spraay_webhook_testTest webhook delivery$0.002✅ Persistent
spraay_webhook_listList registered webhooks$0.001✅ Persistent
spraay_webhook_deleteDelete webhook$0.001✅ Persistent
spraay_xmtp_sendSend encrypted XMTP message$0.003✅ Live
spraay_xmtp_inboxRead XMTP inbox$0.002✅ Live

Infrastructure ($0.001–$0.005)

ToolDescriptionCostStatus
spraay_rpc_callMulti-chain JSON-RPC via Alchemy$0.001✅ Live
spraay_rpc_chainsList supported RPC chains$0.001✅ Live
spraay_storage_pinPin to IPFS via Pinata$0.005✅ Live
spraay_storage_getRetrieve pinned content$0.002✅ Live
spraay_storage_statusCheck pin status$0.001✅ Live
spraay_cron_createCreate scheduled job$0.005✅ Persistent
spraay_cron_listList scheduled jobs$0.001✅ Persistent
spraay_cron_cancelCancel scheduled job$0.001✅ Persistent
spraay_logs_ingestIngest structured logs$0.001✅ Persistent
spraay_logs_queryQuery logs$0.003✅ Persistent

Identity & Access ($0.001–$0.05) — persistent

ToolDescriptionCost
spraay_kyc_verifyInitiate KYC/KYB verification$0.05
spraay_kyc_statusCheck KYC status$0.005
spraay_auth_sessionCreate scoped auth session$0.005
spraay_auth_verifyVerify session token$0.001

Compliance ($0.001–$0.02) — persistent

ToolDescriptionCost
spraay_audit_logRecord audit trail entry$0.001
spraay_audit_queryQuery audit trail$0.005
spraay_tax_calculateCalculate crypto tax (FIFO)$0.01
spraay_tax_reportRetrieve tax report$0.02

Data ($0.001–$0.002)

ToolDescriptionCost
spraay_pricesLive token prices on Base$0.002
spraay_balancesETH + ERC-20 balances for any wallet$0.002
spraay_resolveENS / Basename resolution$0.001

How It Works

  1. AI agent calls a tool (e.g. spraay_batch_execute)
  2. MCP server hits the Spraay x402 Gateway
  3. Gateway returns 402 Payment Required with USDC amount
  4. @x402/axios auto-signs a USDC micropayment from your wallet
  5. Gateway validates payment and returns data
  6. Agent gets the response

All payments are micro-transactions ($0.001–$0.05) in USDC on Base mainnet.


Requirements

  • Wallet: EVM private key with USDC on Base (even $1 covers thousands of calls)
  • Node.js: 18+
  • MCP Client: Claude Desktop, Cursor, or any MCP-compatible client

Environment Variables

VariableRequiredDefaultDescription
EVM_PRIVATE_KEYYes—Wallet private key for USDC payments
SPRAAY_GATEWAY_URLNohttps://gateway.spraay.appOverride gateway URL

Links

License

MIT

Ver o original no GitHub

Bom para

Relacionados