mcp

PyPI version License: MIT

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

1. Visit https://coinrailz.com/credits
2. Purchase credits with Stripe (credit card) or USDC
3. Generate an API key
4. 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

• Documentation: https://coinrailz.com/developers
• Issues: https://github.com/tdnupe3/mcp-server-coinrailz/issues
• Email: [email protected]

License

MIT License - see LICENSE file