Spraay Solana Gateway

io.github.plagtechPublished by GitHub account plagtechv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Remote MCP gateway that lets an assistant batch-send SOL or SPL tokens to many Solana wallets, get cost quotes and check transaction status, paying per call…

What you can do
  • Send SOL in batches to up to 1000 recipients, with automatic chunking of large batches
  • Send any SPL token (USDC, BONK, WIF, JUP and others) in batches, with automatic token account creation
  • Estimate the cost of a batch send, including fees, transaction count and timing
  • Look up the status of a Solana transaction by its signature
When to use it
Useful when an agent needs to distribute SOL or SPL tokens to many Solana addresses in one operation, or to price and track such payouts. Each call is paid in USDC over the x402 protocol, so it suits agents that can settle small per-request payments.
Requirements
Remote streamable HTTP endpoint at gateway-solana.spraay.app; no API keys or accounts are declared. A Solana wallet able to pay USDC per request via the x402 flow (payment proof sent in the X-PAYMENT header) and network access are needed. The README also describes self-hosting from source with Node.js and a treasury wallet private key.
Before you install
Every tool costs money in USDC per call (0.01 for batch sends, 0.001 for quote and status), and batch sends move real SOL or SPL tokens to up to 1000 recipients, so mistakes are irreversible on-chain. Payment proof goes in the X-PAYMENT header and payments are verified by third-party facilitators. Self-hosting requires configuring a treasury wallet private key in a .env file.

Installation

In SourceWeft

  1. Open Spraay Solana Gateway in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.plagtech%2Fspraay-solana-gateway/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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

Source: README.md at commit 66b7576

Tools

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.

Parametersrecipientsrequired

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.

Parametersmintrequiredrecipientsrequired

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.

Parameterstokenrecipientsrequired

spraay_solana_status

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

Parameterstxidrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts