English Français العربية

io.github.plagtech/spraay-solana-gateway

Official registry Finance and payments

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http spraay-solana-gateway 'https://gateway-solana.spraay.app/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "spraay-solana-gateway": {
            "type": "http",
            "url": "https://gateway-solana.spraay.app/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 💧 Spraay Solana Gateway
  2. 🏗️ Architecture
  3. 📡 Endpoints
  4. 🚀 Quick Start
  5. 📖 API Usage
  6. 🔐 x402 Payment Flow
  7. 🤖 MCP Server
  8. 🌐 Deployment
  9. 🔗 Spraay Ecosystem
  10. 📄 License

💧 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
git clone https://github.com/plagtech/spraay-solana-gateway.git
cd spraay-solana-gateway
npm install
2. Configure
cp .env.example .env
# Edit .env with your treasury wallet and private key
3. Run
npm run dev    # development (auto-reload)
npm start      # production

📖 API Usage

Batch Send SOL
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
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
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:

# Install MCP SDK
npm install @modelcontextprotocol/sdk

# Run MCP server
node 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: CNAME
Name: gateway-solana
Value: <railway-app-url>.railway.app
TTL: 600

🔗 Spraay Ecosystem

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

📄 License

MIT

Frequently asked questions

What is io.github.plagtech/spraay-solana-gateway?

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

How do I install io.github.plagtech/spraay-solana-gateway?

It runs as a remote server. In Claude Code: claude mcp add --transport http spraay-solana-gateway 'https://gateway-solana.spraay.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.plagtech/spraay-solana-gateway need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.plagtech/spraay-solana-gateway open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.plagtech/spraay-solana-gateway?

It is published by plagtech. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.