Spraay Solana Gateway

io.github.plagtech由 GitHub 账号 plagtech 发布v1.0.0更新于 Oct 24, 2026

Batch send SOL or any SPL token to 1000+ wallets via x402. AI agent payments on Solana.

已验证Streamable HTTP可网页运行金融商业与电商

概览

AI 生成的概览

远程 MCP 网关,让助手批量向多个 Solana 钱包发送 SOL 或 SPL 代币、获取费用报价并查询交易状态,每次调用以 USDC 付费。

可以做什么
  • 批量向最多 1000 个收款地址发送 SOL,大批量会自动分片
  • 批量发送任意 SPL 代币(USDC、BONK、WIF、JUP 等),并自动创建代币账户
  • 估算批量发送的成本,返回费用、交易笔数和预计耗时
  • 按交易签名查询 Solana 交易状态
适用场景
适合需要一次性向大量 Solana 地址分发 SOL 或 SPL 代币的代理场景,或需要先估价、再跟踪这类付款的情况。每次调用都通过 x402 协议以 USDC 付费,因此适用于能够完成小额按次支付的代理。
运行要求
远程 streamable HTTP 端点 gateway-solana.spraay.app,未声明需要 API 密钥或账户。需要一个能通过 x402 流程按次支付 USDC 的 Solana 钱包(支付凭证放在 X-PAYMENT 请求头中),并需要网络访问。README 还介绍了用 Node.js 从源码自建并配置资金钱包私钥的方式。
安装前请注意
每个工具每次调用都要花 USDC(批量发送 0.01,报价和状态查询 0.001),批量发送会向最多 1000 个地址转移真实的 SOL 或 SPL 代币,链上操作无法撤销。支付凭证通过 X-PAYMENT 请求头发送,付款由第三方 facilitator 验证。自建时需要在 .env 中配置资金钱包私钥。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Spraay Solana Gateway,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.plagtech%2Fspraay-solana-gateway/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "spraay-solana-gateway": {
      "type": "http",
      "url": "https://gateway-solana.spraay.app/mcp"
    }
  }
}

README

💧 Spraay Solana Gateway

x402-powered batch payment infrastructure for AI agents on Solana.

Any AI agent can batch send SOL, USDC, BONK, or any SPL token to 1,000+ wallets via the x402 payment protocol. No API keys. No accounts. Pay per request.

🏗️ Architecture

AI Agent (any framework)    │    ├── HTTP Request    │    ▼┌──────────────────────────────────────────┐│   Spraay Solana Gateway                  ││   gateway-solana.spraay.app              ││                                          ││   @x402/express + @x402/svm             ││   ┌─────────────┐  ┌──────────────┐     ││   │ x402 Payment│  │ Solana Batch │     ││   │ Middleware   │  │ Engine       │     ││   └──────┬──────┘  └──────┬───────┘     ││          │                │              ││          ▼                ▼              ││   USDC payment     Execute batch        ││   verified via     SOL/SPL transfers    ││   facilitator                           │└──────────────────────────────────────────┘    │    ▼Solana Network

📡 Endpoints

EndpointMethodPriceDescription
/solana/batch-send-solPOST$0.01Batch send SOL to multiple wallets
/solana/batch-send-tokenPOST$0.01Batch send any SPL token
/solana/quoteGET$0.001Get cost estimate
/solana/status/:txidGET$0.001Check transaction status
/healthGETFreeHealth check
/.well-known/x402GETFreex402 discovery manifest

🚀 Quick Start

1. Clone & Install

bash
git clone https://github.com/plagtech/spraay-solana-gateway.gitcd spraay-solana-gatewaynpm install

2. Configure

bash
cp .env.example .env# Edit .env with your treasury wallet and private key

3. Run

bash
npm run dev    # development (auto-reload)npm start      # production

📖 API Usage

Batch Send SOL

bash
curl -X POST https://gateway-solana.spraay.app/solana/batch-send-sol \  -H "Content-Type: application/json" \  -H "X-PAYMENT: <base64 payment proof>" \  -d '{    "recipients": [      { "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM", "amount": 0.01 },      { "address": "7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyLWP9SfKFJ", "amount": 0.02 }    ]  }'

Batch Send SPL Token

bash
curl -X POST https://gateway-solana.spraay.app/solana/batch-send-token \  -H "Content-Type: application/json" \  -H "X-PAYMENT: <base64 payment proof>" \  -d '{    "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",    "recipients": [      { "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM", "amount": 1000 },      { "address": "7S3P4HxJpyyigGzodYwHtCxZyUQe9JiBMHyLWP9SfKFJ", "amount": 500 }    ]  }'

Get Quote

bash
curl "https://gateway-solana.spraay.app/solana/quote?recipients=100&token=BONK"

🔐 x402 Payment Flow

  1. Agent sends request without payment header
  2. Gateway returns 402 Payment Required with Solana USDC payment instructions
  3. Agent sends USDC on Solana to the treasury address
  4. Agent retries request with payment proof in X-PAYMENT header
  5. Gateway verifies payment via facilitator, executes batch transfer

Supported facilitators:

  • Devnet: https://x402.org/facilitator
  • Mainnet: https://facilitator.payai.network (PayAI — free tx fees)

🤖 MCP Server

The gateway includes an MCP server for AI agent framework integration:

bash
# Install MCP SDKnpm install @modelcontextprotocol/sdk
# Run MCP servernode mcp/spraay-solana-mcp.js

Tools available:

  • spraay_solana_batch_send_sol — Batch send SOL
  • spraay_solana_batch_send_token — Batch send SPL tokens
  • spraay_solana_quote — Cost estimation
  • spraay_solana_tx_status — Transaction lookup

🌐 Deployment

Railway

  1. Create new service in Railway project
  2. Connect GitHub repo: plagtech/spraay-solana-gateway
  3. Set environment variables in Railway dashboard
  4. Deploy → configure custom domain

DNS (GoDaddy)

Type: CNAMEName: gateway-solanaValue: <railway-app-url>.railway.appTTL: 600

🔗 Spraay Ecosystem

ServiceURL
Spraay Appspraay.app
Base Gatewaygateway.spraay.app
Solana Gatewaygateway-solana.spraay.app
GitHubgithub.com/plagtech
Twitter@Spraay_app

📄 License

MIT

来源:README.md,提交 66b7576

工具

4

spraay_solana_batch_send_sol

Batch send SOL to multiple Solana wallets in one call. Supports up to 1000 recipients. Auto-chunks large batches. Costs $0.01 USDC via x402 protocol.

输入参数recipients必填

spraay_solana_batch_send_token

Batch send any SPL token (USDC, BONK, WIF, JUP, etc.) to multiple Solana wallets. Auto-creates token accounts. Costs $0.01 USDC via x402.

输入参数mint必填recipients必填

spraay_solana_quote

Get a cost estimate for a Spraay batch send on Solana. Returns fees, tx count, and timing. Costs $0.001 USDC via x402.

输入参数tokenrecipients必填

spraay_solana_status

Check the status of a Solana transaction by its signature. Costs $0.001 USDC via x402.

输入参数txid必填

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分