io.github.plagtech/spraay-x402-mcp

平台与服务

by plagtech

面向 Spraay x402 Gateway 的 MCP server,提供 60 个工具,支持 Base 上的加密支付、DeFi 与 AI。

什么是 io.github.plagtech/spraay-x402-mcp

面向 Spraay x402 Gateway 的 MCP server,提供 60 个工具,支持 Base 上的加密支付、DeFi 与 AI。

README

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:

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

Cursor

Add to .cursor/mcp.json:

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

Smithery

bash
smithery mcp add Plagtech/Spraay-x402-mcp

From Source

bash
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_KEYYesWallet private key for USDC payments
SPRAAY_GATEWAY_URLNohttps://gateway.spraay.appOverride gateway URL

Links

License

MIT

常见问题

io.github.plagtech/spraay-x402-mcp 是什么?

面向 Spraay x402 Gateway 的 MCP server,提供 60 个工具,支持 Base 上的加密支付、DeFi 与 AI。

相关 Skills

MCP构建

by anthropics

Universal
热门

聚焦高质量 MCP Server 开发,覆盖协议研究、工具设计、错误处理与传输选型,适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。

想让 LLM 稳定调用外部 API,就用 MCP构建:从 Python 到 Node 都有成熟指引,帮你更快做出高质量 MCP 服务器。

平台与服务
未扫描123.0k

Slack动图

by anthropics

Universal
热门

面向Slack的动图制作Skill,内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程,适合把创意或上传图片快速做成可直接发送的Slack动画。

帮你快速做出适配 Slack 的动图,内置约束规则和校验工具,少踩上传与播放坑,做表情包和演示都更省心。

平台与服务
未扫描123.0k

邮件模板

by alirezarezvani

Universal
热门

快速搭建生产可用的事务邮件系统:生成 React Email/MJML 模板,接入 Resend、Postmark、SendGrid 或 AWS SES,并支持本地预览、i18n、暗色模式、反垃圾优化与追踪埋点。

面向营销与服务场景,快速搭建高质量邮件模板,省去反复设计与切图成本,成熟度和社区认可都很高。

平台与服务
未扫描12.5k

相关 MCP Server

Slack 消息

编辑精选

by Anthropic

热门

Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。

这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点,特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过,它目前只是参考实现,文档有限,不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。

平台与服务
84.2k

by netdata

热门

io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。

这个工具解决了运维人员需要手动检查系统状态的痛点,最适合 DevOps 团队让 Claude 自动分析性能数据。不过,它依赖 NetData 的现有部署,如果你没用过这个监控平台,得先花时间配置。

平台与服务
78.5k

by d4vinci

热门

Scrapling MCP Server 是专为现代网页设计的智能爬虫工具,支持绕过 Cloudflare 等反爬机制。

这个工具解决了爬取动态网页和反爬网站时的头疼问题,特别适合需要批量采集电商价格或新闻数据的开发者。不过,它依赖外部浏览器引擎,资源消耗较大,不适合轻量级任务。

平台与服务
38.1k

评论