Spraay x402 MCP Server

Gateway de pagamento multi-chain x402 e servidor MCP de automação DeFi. 161 ferramentas em 39 categorias — pagamentos em lote, swaps de tokens, pontes, escrow, inferência de IA, staking, governança, oráculos, geoespacial, computação GPU, pesquisa e muito mais. Suporta Base, Ethereum e Solana com mais de 10 blockchains adicionais. Integrado às ferramentas AWS Strands Agents e ao Google ADK Community Toolkit.

GitHub

Experimente este MCPPatrocinado

Documentação

💧 Spraay x402 MCP Server

Infraestrutura DeFi full-stack para agentes de IA — 183 ferramentas pagas por chamada, com suporte do Gateway Spraay x402 de 192 endpoints na Base, com trilhas de pagamento em Solana, Ethereum, XRP e Stellar.

Conecte Claude, Cursor ou qualquer cliente MCP a pagamentos onchain, pagamentos em lote, swaps, pontes, folha de pagamento, faturamento, escrow, dados de oráculos, análises, mais de 200 modelos de IA, GPU/computação, APIs de pesquisa, busca/RAG e muito mais. Agentes pagam USDC por requisição via protocolo x402 — sem chaves de API, sem contas.

A lista de ferramentas é gerada a partir do manifesto do gateway em tempo de build (npm run sync), então o catálogo autoritativo e os preços sempre vivem no gateway — veja Catálogo de ferramentas. 24 dos endpoints do gateway são gratuitos (sem necessidade de pagamento).

Início Rápido

Instale e use — sem configuração, sem chaves de API, sem variáveis de ambiente. Na primeira execução, o servidor cria automaticamente uma carteira, salva-a em ~/.spraay/.session e imprime o endereço no stderr. Financie esse endereço com USDC na Base e comece a chamar as ferramentas.

Leia Segurança e Segurança da Carteira — essas ferramentas movem fundos reais.

Instalação em uma linha (Claude Code)

claude mcp add spraay -s user -- npx -y spraay-x402-mcp

Configuração manual (Cursor / Claude Desktop)

Cursor (.cursor/mcp.json) ou Claude Desktop (claude_desktop_config.json):

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

É isso. A primeira execução imprime algo como:

💧 Spraay created a new wallet: 0xABC…123
   Private key saved to ~/.spraay/.session (keep it safe — it controls funds).
   Fund this address with USDC on Base to start paying for tool calls.

Opcional — use sua própria carteira

Para assinar com uma chave que você já controla em vez da criada automaticamente, defina EVM_PRIVATE_KEY no seu ambiente (isso substitui a carteira da sessão). Nunca cole uma chave bruta em um arquivo de configuração commitado — use uma carteira quente dedicada financiada apenas com o que o agente pode gastar. Veja Segurança e Segurança da Carteira.

URL remota (sem carteira na sua máquina)

A liquidação é tratada no lado do gateway; seu cliente nunca mantém uma chave de assinatura.

{
  "mcpServers": {
    "spraay": {
      "url": "https://spraay-x402-mcp--plagtech.run.tools"
    }
  }
}

Smithery

smithery mcp add Plagtech/Spraay-x402-mcp

A partir do código-fonte

git clone https://github.com/plagtech/spraay-x402-mcp
cd spraay-x402-mcp
npm install
npm run build
npm start                     # auto-creates a wallet on first run

Catálogo de ferramentas

183 ferramentas abrangendo as 33 categorias do gateway. Destaques por área:

Área	O que cobre
IA e Inferência	Mais de 200 LLMs (compatíveis com OpenAI), classificação de carteira/tx, explicação de contratos, resumos
Computação	Texto / imagem / vídeo / TTS / STT / embeddings em Replicate, Chutes, OpenRouter; trabalhos em lote
Futuros de Computação	Créditos de computação pré-pagos com descontos por nível; saque por inferência
Bittensor	Inferência descentralizada, geração de imagem e embeddings via SN64 / SN19
Pagamentos	Pagamentos em lote para até 200 destinatários (Base, XRP Ledger, Stellar); estimativas
Folha de Pagamento	Execuções de folha de pagamento em stablecoin na Base, Ethereum, Solana
Faturamento e Escrow	Faturas nativas de cripto e escrow por marcos (persistentes)
DeFi e Dados	Swaps (Uniswap V3 / Aerodrome), preços de oráculos/gás/FX, cotações de pontes, saldos, ENS/Basename
Análises	Perfis de carteira e histórico de transações decodificado
Pesquisa	Mais de 250M de artigos (OpenAlex), arXiv, Crossref, PubMed, PubChem, Censo dos EUA, dicionário
Busca e RAG	Busca na web, extração de conteúdo, resposta a perguntas
Comunicação	E-mail, SMS, mensagens XMTP, webhooks
Infraestrutura	RPC multi-chain, armazenamento IPFS/Arweave, agendamento cron, logs estruturados
Identidade e Conformidade	Triagem KYC/sanções, sessões de autenticação, trilha de auditoria, imposto de cripto (FIFO, IRS 8949)
Cadeia de Suprimentos (SCTP)	Registro de fornecedores, ordens de compra, verificação de faturas, liquidação
Robótica (RTP)	Registrar robôs, despachar tarefas pagas, conclusão com suporte de escrow
Confiança e Segurança	Pontuações de confiança ProofLayer; verificações gratuitas de segurança de token, segurança de endereço e decodificação de tx

24 endpoints gratuitos não exigem pagamento — gás/preços/status da cadeia, validação de endereço e lote, resolução ENS, conversão de unidades, sondas de descoberta x402 e descoberta de modelo/computação.

Para a lista exata e atual de ferramentas e preços por ferramenta, consulte o manifesto ao vivo:

curl https://gateway.spraay.app/.well-known/x402.json

Os preços variam de $0,001 (leituras) a ~$0,10 (folha de pagamento, liberação de escrow, imposto), liquidados em USDC na Base.

Como funciona

Um agente chama uma ferramenta (ex.: spraay_batch_execute).
O servidor MCP acessa o Gateway Spraay x402.
O gateway responde 402 Payment Required com um valor em USDC.
Modo remoto: a liquidação é tratada no lado do gateway. Modo local: @x402/axios assina um micropagamento em USDC da carteira criada automaticamente (ou substituída).
O gateway valida o pagamento e retorna os dados.

Segurança e Segurança da Carteira

Essas ferramentas podem iniciar pagamentos reais em USDC. Trate o servidor como qualquer ferramenta com acesso a fundos.

A carteira criada automaticamente só contém o que você enviar a ela. Financie-a apenas com o USDC que você está disposto a deixar o agente gastar. Ela começa vazia, então uma instalação nova não pode mover fundos até você financiá-la; ferramentas somente leitura funcionam independentemente.
A chave da sessão fica em ~/.spraay/.session. Proteja esse arquivo como qualquer segredo — qualquer pessoa que o ler controla a carteira. Ele é escrito com permissões 0600 em sistemas POSIX. Faça backup se os fundos importarem; exclua-o para rotacionar para uma nova carteira na próxima execução.
Prefira a URL remota se preferir não manter nenhuma chave de assinatura na sua máquina — a liquidação é tratada no lado do gateway.
Se você trouxer sua própria chave via EVM_PRIVATE_KEY, use uma carteira quente dedicada que não controle outros ativos, e nunca coloque uma chave privada bruta em um arquivo de configuração, issue ou qualquer arquivo commitado — mantenha-a apenas no seu ambiente de shell.

O pacote npm publicado inclui apenas dist/, README e LICENSE (verifique com npm pack --dry-run) — sem binários, sem ferramentas de build, sem scripts de instalação.

Relate problemas de segurança para security@spraay.app, não em um issue público.

Requisitos

Node.js 20+
Cliente MCP — Claude Desktop, Cursor ou qualquer cliente compatível com MCP
USDC na Base — financie a carteira criada automaticamente (ou a sua); até $1 cobre milhares de chamadas

Variáveis de ambiente

Nenhuma é necessária — o servidor roda com zero configuração. Todas as seguintes são substituições opcionais.

Variável	Obrigatória	Padrão	Descrição
`EVM_PRIVATE_KEY`	Não	criada automaticamente em `~/.spraay/.session`	Substitui a carteira criada automaticamente pela sua própria chave. Use uma carteira quente dedicada, financiada conforme necessário.
`SPRAAY_GATEWAY_URL`	Não	`https://gateway.spraay.app`	Substitui a URL do gateway.

Licença

MIT