Coin Railz MCP Server

A Model Context Protocol (MCP) server exposing 63 Coin Railz tools to Claude and other LLMs. Access blockchain analytics, trading signals, satellite/earth data (NASA & ESA), IoT sensor feeds, AI inference, prediction markets, and more. This package uses API-key credits for paid calls and reports x402 requirements; it does not sign or settle on-chain payments. The platform catalog contains 80 services; this standalone package does not wrap every platform service.

Features

• 63 Tools for Claude: Service wrappers and account helpers; not complete coverage of the platform catalog
• Trial eligibility: The platform may offer eligible first calls; eligibility and availability are checked server-side
• API Key Authentication: Simple prepaid credits system — no blockchain knowledge required
• x402 challenge handling: Reports payment requirements; this package does not create wallets, sign payments or automatically settle on-chain
• 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

Trial availability is determined by the platform. If no eligible trial is available, a payment-required response remains an error, not a successful call.

Maintenance candidate: 1.2.1

This candidate requires Python 3.10+, MCP >=1.30.0,<2 and HTTPX >=0.28.1,<1. It retains the same explicit 63-tool subset; the platform's 80-service catalog is broader than this package. API-key credits are the implemented paid-call path. Native x402 signing and settlement are not provided.

The candidate is not available from PyPI until its separate release is approved and published. Check the actual registry version before pinning an installation.

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

The prices below and in the tool tables are illustrative, not authoritative quotes. Consult the current platform catalog or payment-required response before funding or calling a service.

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: support@coinrailz.com

License

MIT License - see LICENSE file