Coin Railz MCP Server

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

License

MIT License - see LICENSE file

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for tdnupe3 from gravatar.com tdnupe3

Credits

Author: Coin Railz

License

MIT License (MIT)

Requires

Python >=3.10

Tags

mcp claude anthropic coinbase agentkit crypto blockchain x402 payments defi trading ethereum base usdc nasa satellite iot depin ai-inference

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

coinrailz_mcp-1.2.0-py3-none-any.whl (20.3 kB view details)

Uploaded Python 3

File details

Details for the file coinrailz_mcp-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: coinrailz_mcp-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 20.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for coinrailz_mcp-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6c2efc779114d9caaf37fc6dc9b95feef6879e8002b53b1fedc98cea5543e96b
MD5 a7167c13c4ffc2423d49255f6cbd7f34
BLAKE2b-256 beeb10c0a5a83f2142ee9e8e22f774346b377050143f0cecaf726b343f1d9518

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.2.0 This release

1 file

1.1.0

1 file

1.0.5

2 files

1.0.4

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page