SolSigs MCP Server
io.github.gra-kir/solsigs-mcp
Documentation
SolSigs Python Client · 
Pay-per-call Solana data APIs for AI agents via x402 micropayments.
No API keys. No subscriptions. Agents pay in USDC per call.
Claude Desktop (Native x402)
Claude agents can pay for SolSigs APIs natively — 30 second setup.
pip install solsigs-py
Then add this to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"solsigs": {
"command": "solsigs-mcp"
}
}
}
Restart Claude Desktop. Your agent now has 15 Solana research tools with native x402 micropayments.
Why a local command? Claude Desktop only supports stdio transport. solsigs-mcp is a local proxy that bridges stdio ↔ the remote SolSigs MCP server over SSE. Full example: examples/claude_solsigs_agent.py
🔗 Anthropic official x402 docs
Install
pip install solsigs-py # base client
pip install solsigs-py[langgraph] # + LangGraph tools
Quick Start
from solsigs import SolSigsClient
client = SolSigsClient()
# DEX price for any Solana token
price = client.get_dex_price("DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263")
print(price) # → $0.002 USDC
# Multi-token batch pricing + OHLCV
prices = client.batch_token_pricing(["SOL", "BONK", "WIF"], period="1h")
# Wallet risk scoring
report = client.score_wallet("7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV")
# Arbitrage scan
arbs = client.scan_arbitrage(min_spread_pct=0.5)
Payment flow
Agent calls endpoint → 402 Payment Required → Pays USDC → Retries → Gets data
The client handles the HTTP layer. Integrate your agent's Solana wallet for automated x402 payment.
MCP Server
SolSigs ships as an MCP server (Model Context Protocol) — Claude, Hermes, Cursor, and any MCP-compatible agent can call SolSigs tools natively.
Claude Desktop users: use the solsigs-mcp command above (stdio bridge).
Hermes, Cursor, and other SSE-capable MCP clients:
{
"mcpServers": {
"solsigs": {
"url": "https://solsigs.com/sse",
"transport": "sse"
}
}
}
15 MCP tools — all 14 HTTP endpoints + Polymarket prediction markets:
Data & Pricing (5)
| Tool | Description | Price |
|---|---|---|
get_dex_price | Single-token DEX price feed (Jupiter + Birdeye) | $0.002 |
batch_token_pricing | Multi-token pricing + OHLCV candles + metadata | $0.003 |
get_market_summary | AI-powered on-chain market summary (Groq LLM) | $0.008 |
get_staking_rates | Cross-protocol APY comparison (Marinade, Jito, Blaze, Sanctum) | $0.002 |
get_dev_activity | GitHub commit activity + audit status for Solana protocols | $0.001 |
Trading & Arbitrage (2)
| Tool | Description | Price |
|---|---|---|
scan_arbitrage | Cross-DEX arbitrage scanner | $0.010 |
get_prediction_market | Polymarket prediction markets (crypto, politics, sports) | $0.003 |
Intelligence & Tracking (5)
| Tool | Description | Price |
|---|---|---|
analyze_wallet | Wallet risk scoring + wash trading detection | $0.005 |
detect_token_launches | New token launch detection (pump.fun, Raydium) | $0.003 |
get_whale_activity | Whale wallet tracking + smart money signals | $0.006 |
get_nft_intel | NFT floor prices, rarity, wash trading per collection | $0.004 |
get_social_sentiment | On-chain social sentiment + influencer tracking | $0.004 |
Infrastructure (3)
| Tool | Description | Price |
|---|---|---|
rpc_relay | Pay-per-call Helius RPC relay | $0.001 |
create_alert | Webhook alert registration (price, volume, whale, launches) | $0.005 |
wallet_status | Check MCP wallet USDC/SOL balance | FREE |
LangGraph Integration
from solsigs.langgraph_tools import SOLSIGS_LANGGRAPH_TOOLS
# Add to your LangGraph agent
from langgraph.prebuilt import create_react_agent
agent = create_react_agent(model, SOLSIGS_LANGGRAPH_TOOLS)
# Your agent can now:
agent.invoke({"messages": ["What's the current price of BONK?"]})
agent.invoke({"messages": ["Compare staking APY across Solana protocols"]})
See examples/langgraph_agent.py for a full multi-step agent demo.
Available HTTP Endpoints (14)
Data & Pricing (5)
| Endpoint | Description | Price |
|---|---|---|
/dex | Single-token DEX price feed (Jupiter + Birdeye) | $0.002 |
/price | Batch multi-token pricing + OHLCV candles + metadata | $0.003 |
/summary | AI on-chain data summarization (Groq LLM) | $0.008 |
/staking | Cross-protocol staking APY comparison | $0.002 |
/dev | Protocol developer activity + audit status | $0.001 |
Trading & Arbitrage (2)
| Endpoint | Description | Price |
|---|---|---|
/arb | Arbitrage scanner | $0.010 |
/predict | Polymarket prediction markets | $0.003 |
Intelligence & Tracking (5)
| Endpoint | Description | Price |
|---|---|---|
/wallet | Wallet risk scoring | $0.005 |
/launches | Early token launch detection | $0.003 |
/whale | Whale wallet tracking + smart money signals | $0.006 |
/nft | NFT floor prices, rarity, wash trading | $0.004 |
/social | On-chain social sentiment + influencer tracking | $0.004 |
Infrastructure (2)
| Endpoint | Description | Price |
|---|---|---|
/rpc | RPC load balancer | $0.001 |
/alerts | Webhook alert registration | $0.005 |
SolSigs ProofGuard
ProofGuard is a signed receipt and refund-evidence layer for x402-paid agent endpoints on Solana.
It returns:
- endpoint trust score;
- payment expectation receipt;
- payment fulfillment receipt;
- refund evidence package.
Live endpoint:
POST https://solsigs.com/proofguard/evaluate
Price: 0.003 USDC via x402 on Solana mainnet
ProofGuard explicitly labels evidence mode as solsigs_instrumented, proofguard_probed, or self_attested, so agents can distinguish real observed proof from caller-supplied claims.
See docs/proofguard.md.
Why x402?
- No API keys — payment is the only gate
- No subscriptions — pay only for what you use
- Agent-native — designed for autonomous agent commerce
- Solana speed — transactions finalize in <1s, fees <$0.001
- Claude native — Anthropic official x402 support, zero setup for Claude users
Links
License
MIT