Coin Railz MCP Server
A Model Context Protocol (MCP) server exposing 63 Coin Railz x402 micropayment services to Claude and other LLMs. Access blockchain analytics, trading signals, satellite/earth data (NASA & ESA), IoT sensor feeds, AI inference, prediction markets, and more — all paid with USDC credits or native x402 on-chain payments.
Features
- 63 Tools for Claude: Complete coverage across 14 service categories
- First-Call Free:
gas-price-oracle and token-metadata are FREE for first-time users
- API Key Authentication: Simple prepaid credits system — no blockchain knowledge required
- x402 Protocol Support: Native USDC micropayments on Base for crypto-native agents
- Coinbase AgentKit Compatible: Works with AgentKit MCP Extension out of the box
- 14 Service Categories: From trading intelligence to NASA satellite data
Quick Start
Installation
pip install coinrailz-mcp
Configure Claude Desktop
Add to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"coinrailz": {
"command": "python",
"args": ["-m", "coinrailz_mcp"],
"env": {
"COINRAILZ_API_KEY": "your-api-key-here"
}
}
}
}
Get an API Key
- Visit https://coinrailz.com/credits
- Purchase credits with Stripe (credit card) or USDC
- Generate an API key
- Set the
COINRAILZ_API_KEY environment variable
Free Trial: gas-price-oracle and token-metadata are FREE for your first call!
Available Tools (63)
Category 1: Discovery & Testing (1)
| Tool | Description | Price |
|---|
ping_coinrailz | Test platform connectivity | $0.25 |
Category 2: Trading Intelligence (14)
| Tool | Description | Price |
|---|
get_gas_prices | Real-time gas across 6 chains | $0.10 (FREE first) |
get_token_metadata | Token name, symbol, decimals | $0.10 (FREE first) |
get_token_price | Real-time DEX prices | $0.25 |
get_token_sentiment | AI social sentiment | $0.25 |
get_trending_tokens | Trending by volume | $0.50 |
get_whale_alerts | Large transaction alerts | $0.35 |
get_dex_liquidity | DEX liquidity depth | $0.20 |
get_trade_signals | AI trading signals | $0.75 |
get_trading_signal | Symbol-specific signals | $1.00 |
get_sentiment_analysis | Multi-source sentiment | $0.50 |
get_arbitrage_opportunities | Cross-chain arb scanner | $1.25 |
get_correlation_matrix | Token correlations | $0.75 |
get_risk_metrics | Volatility, VaR, drawdown | $1.00 |
get_batch_quote | Multi-token quotes | $0.40 |
Category 3: Execution & Infrastructure (4)
| Tool | Description | Price |
|---|
get_multi_chain_balance | Wallet balances across chains | $0.50 |
build_transaction | Build unsigned transactions | $0.30 |
manage_approvals | Token approval manager | $0.20 |
bridge_tokens | Cross-chain bridge quotes | $2.00 |
Category 4: Premium Services (4)
| Tool | Description | Price |
|---|
scan_smart_contract | Contract security scan | $1.00 |
get_wallet_risk_score | Wallet risk analysis | $0.50 |
track_portfolio | Portfolio analytics | $0.50 |
optimize_portfolio | AI portfolio optimization | $2.00 |
Category 5: Real Estate (3)
| Tool | Description | Price |
|---|
get_property_valuation | AI property valuation | $0.75 |
analyze_lease | Lease term analysis | $1.00 |
track_construction_progress | Construction tracking | $1.50 |
Category 6: Banking/Finance (3)
| Tool | Description | Price |
|---|
get_credit_risk_score | Credit risk assessment | $1.25 |
detect_fraud | AI fraud detection | $0.75 |
run_compliance_check | AML/KYC checks | $1.75 |
Category 7: Polymarket Prediction Markets (4)
| Tool | Description | Price |
|---|
get_polymarket_events | Active prediction markets | $0.25 |
get_polymarket_odds | Event odds | $0.50 |
search_polymarket | Search events | $0.25 |
get_prediction_market_odds | Aggregated odds | $0.50 |
Category 8: AI Agent Infrastructure (3)
| Tool | Description | Price |
|---|
create_agent_wallet | Create Coinbase CDP agent wallet | $2.00 |
create_instant_agent_wallet | Instant temp wallet | $1.00 |
verify_agent_identity | ERC-8004 on-chain identity | $5.00 |
Category 9: Enterprise Services (3)
| Tool | Description | Price |
|---|
request_smart_contract_audit | Full security audit | $10.00 |
request_payment_processing | Merchant payment setup | $0.50 |
request_compliance_consultation | AML/KYC consulting | $5.00 |
Category 10: Traditional Markets (2)
| Tool | Description | Price |
|---|
get_stock_sentiment | AI stock market sentiment (AAPL, TSLA, etc.) | $0.40 |
get_forex_sentiment | AI forex pair sentiment (EURUSD, GBPJPY, etc.) | $0.40 |
Category 11: Kalshi Prediction Markets (3)
| Tool | Description | Price |
|---|
get_kalshi_markets | Active CFTC-regulated markets | $0.25 |
get_kalshi_odds | Market odds and orderbook | $0.25 |
search_kalshi | Search markets by keyword | $0.25 |
Category 12: Satellite & Earth Observation (12) — NEW
| Tool | Description | Price |
|---|
get_fire_alerts | NASA FIRMS real-time fire detection | $0.15 |
get_weather_imagery | NASA GIBS satellite weather imagery | $0.15 |
get_vegetation_health | NDVI vegetation health (satellite) | $0.15 |
detect_floods | ESA Sentinel-1 SAR flood mapping | $0.25 |
get_air_quality | ESA Sentinel-5P atmospheric pollutants | $0.15 |
get_land_use | ESA WorldCover land classification | $0.15 |
get_satellite_earthdata | NASA Earthdata gateway | $0.25 |
search_earthdata_granules | Search 1B+ NASA satellite granules | $0.25 |
get_precipitation_data | NASA GPM rain rate data | $0.25 |
get_sea_surface_temperature | NASA MODIS sea surface temp | $0.25 |
get_soil_moisture | NASA SMAP soil moisture | $0.25 |
get_ocean_color | MODIS Aqua chlorophyll-a | $0.25 |
Category 13: IoT & DePIN Data (5) — NEW
| Tool | Description | Price |
|---|
get_fleet_telematics | GPS, fuel, speed from fleet devices | $0.10 |
get_weather_station_data | Hyperlocal IoT weather data | $0.10 |
read_iot_sensor | Single IoT sensor reading | $0.05 |
stream_iot_device | Real-time IoT device stream | $0.10 |
export_iot_bulk_data | Historical IoT data export | $0.25 |
Category 14: AI Inference & Yield (2) — NEW
| Tool | Description | Price |
|---|
run_ai_inference | Pay-per-call GPT-4o-mini via USDC | $0.05 |
find_solana_yield | Solana yield opportunities (Kamino) | $0.25 |
Example Usage in Claude
After configuring the MCP server, try asking Claude:
- "What are the current gas prices on Ethereum and Base?"
- "Get the wallet balance for 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
- "Are there any active wildfires within 100km of 37.7749° N, 122.4194° W?"
- "What is the current sea surface temperature near the Maldives?"
- "Get soil moisture data for latitude 41.8, longitude -87.6"
- "What are the trending tokens on Base right now?"
- "Get trading signals for ETH"
- "Search Polymarket for Bitcoin events"
- "Scan this smart contract for vulnerabilities: 0x..."
- "Run AI inference: summarize the latest DeFi news"
- "Find the best USDC yield on Solana right now"
Environment Variables
| Variable | Description | Required |
|---|
COINRAILZ_API_KEY | Your API key from coinrailz.com/credits | Recommended |
COINRAILZ_BASE_URL | Override base URL (default: https://coinrailz.com) | No |
Pricing
Credits are deducted per service call:
- IoT sensors: $0.05
- Most data services: $0.10 - $0.50
- Analytics & AI: $0.50 - $2.00
- Enterprise services: $5.00 - $10.00
Purchase credits at https://coinrailz.com/credits
Supported Blockchains
- Ethereum
- Base (Coinbase L2)
- Polygon
- BNB Chain (BSC)
- Arbitrum
- Optimism
- Solana
Contributing
Contributions welcome! Please open an issue or submit a PR.
Support
License
MIT License - see LICENSE file