io.github.plagtech/spraay-solana-gateway (MCP Server)

The io.github.plagtech/spraay-solana-gateway MCP server provides access to x402-powered batch payment infrastructure on Solana. It enables batching of SOL or SPL token transfers to 1,000+ wallets, including examples like USDC and BONK, intended for AI agent payment flows on Solana.

🛠️ Key Features

Batch send SOL
Batch send SOL or SPL tokens (e.g., USDC, BONK, any SPL token)
Send to 1,000+ wallets via x402
No API keys, no accounts; pay per request
Exposed via the gateway endpoint gateway-solana.spraay.app

🚀 Use Cases

AI agent payments on Solana
Distributing tokens or SOL to large wallet lists in a single workflow
Token batching for operational or application-level payouts

⚡ Developer Benefits

Simple HTTP-based integration for any AI agent framework
Uses x402 with @x402/express and @x402/svm

⚠️ Limitations

Server description focuses on batch payments to wallets via x402; no other Solana operations are documented

💧 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

code

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

Endpoint	Method	Price	Description
`/solana/batch-send-sol`	POST	$0.01	Batch send SOL to multiple wallets
`/solana/batch-send-token`	POST	$0.01	Batch send any SPL token
`/solana/quote`	GET	$0.001	Get cost estimate
`/solana/status/:txid`	GET	$0.001	Check transaction status
`/health`	GET	Free	Health check
`/.well-known/x402`	GET	Free	x402 discovery manifest

🚀 Quick Start

1. Clone & Install

bash

git clone https://github.com/plagtech/spraay-solana-gateway.git
cd spraay-solana-gateway
npm 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

Agent sends request without payment header
Gateway returns 402 Payment Required with Solana USDC payment instructions
Agent sends USDC on Solana to the treasury address
Agent retries request with payment proof in X-PAYMENT header
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 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

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

DNS (GoDaddy)

code

Type: CNAME
Name: gateway-solana
Value: <railway-app-url>.railway.app
TTL: 600

🔗 Spraay Ecosystem

Service	URL
Spraay App	spraay.app
Base Gateway	gateway.spraay.app
Solana Gateway	gateway-solana.spraay.app
GitHub	github.com/plagtech
Twitter	@Spraay_app

📄 License

MIT

mint	string	required	SPL token mint address (base58)
recipients	array	required	Array of recipients

recipients	number	required	Number of recipients
token	string	optional	Token symbol: SOL, USDC, BONK, etc.

io.github.plagtech/spraay-solana-gateway

io.github.plagtech/spraay-solana-gateway (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

spraay_solana_batch_send_sol

spraay_solana_batch_send_token

spraay_solana_quote

spraay_solana_status

💧 Spraay Solana Gateway

🏗️ Architecture

📡 Endpoints

🚀 Quick Start

1. Clone & Install

2. Configure

3. Run

📖 API Usage

Batch Send SOL

Batch Send SPL Token

Get Quote

🔐 x402 Payment Flow

🤖 MCP Server

🌐 Deployment

Railway

DNS (GoDaddy)

🔗 Spraay Ecosystem

📄 License

Install

Remote endpoint

Related servers