Coin Railz MCP Server

A Model Context Protocol (MCP) server that exposes 41 Coin Railz x402 micropayment services to Claude and other LLMs. Access blockchain data, trading signals, prediction markets, stock/forex sentiment, and crypto analytics directly from Claude.

What is MCP?

MCP (Model Context Protocol) is Anthropic's open standard for connecting AI models to external tools and data sources. This server lets Claude access real-time blockchain and crypto data through Coin Railz's x402 payment infrastructure.

Features

• 41 Crypto Tools for Claude: Complete coverage of blockchain analytics, trading, DeFi, and traditional markets
• 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 payments on Base chain for crypto-native agents
• 10 Service Categories: From trading intelligence to traditional markets sentiment

Quick Start

Installation

# Using pip
pip install coinrailz-mcp

# Or from source
git clone https://github.com/coinrailz/mcp-server-coinrailz.git
cd mcp-server-coinrailz
pip install -e .

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 (41)

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.15
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	$0.50
get_sentiment_analysis	Multi-source sentiment	$0.30
get_arbitrage_opportunities	Cross-chain arb scanner	$1.00
get_correlation_matrix	Token correlations	$0.50
get_risk_metrics	Volatility, VaR, drawdown	$0.40
get_batch_quote	Multi-token quotes	$0.25

Category 3: Execution & Infrastructure (4)

Tool	Description	Price
get_multi_chain_balance	Wallet balances across chains	$0.50
build_transaction	Build unsigned transactions	$0.15
manage_approvals	Token approval manager	$0.30
bridge_tokens	Cross-chain bridge quotes	$0.50

Category 4: Premium Services (4)

Tool	Description	Price
scan_smart_contract	Contract security audit	$2.00
get_wallet_risk_score	Wallet risk analysis	$0.50
track_portfolio	Portfolio analytics	$0.75
optimize_portfolio	AI portfolio optimization	$1.00

Category 5: Real Estate (3)

Tool	Description	Price
get_property_valuation	AI property valuation	$5.00
analyze_lease	Lease term analysis	$3.00
track_construction_progress	Construction tracking	$2.00

Category 6: Banking/Finance (3)

Tool	Description	Price
get_credit_risk_score	Credit risk assessment	$2.00
detect_fraud	AI fraud detection	$0.50
run_compliance_check	AML/KYC checks	$1.00

Category 7: Prediction Markets (4)

Tool	Description	Price
get_polymarket_events	Active prediction markets	$0.25
get_polymarket_odds	Event odds	$0.15
search_polymarket	Search events	$0.20
get_prediction_market_odds	Aggregated odds	$0.50

Category 8: AI Agent Infrastructure (3)

Tool	Description	Price
create_agent_wallet	Create managed agent wallet	$1.00
create_instant_agent_wallet	Instant temp wallet	$0.50
verify_agent_identity	ERC-8004 identity NFT	$2.00

Category 9: Enterprise Services (3)

Tool	Description	Price
request_smart_contract_audit	Full security audit	$1000
request_payment_processing	Merchant payment setup	$50/hr
request_compliance_consultation	AML/KYC consulting	$500

Category 10: Traditional Markets (2) - NEW!

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

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"
• "Analyze the risk score for this wallet address"
• "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..."

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:

• Most services: $0.10 - $1.00
• Premium services: $2.00 - $5.00
• Enterprise services: $50 - $1000

Purchase credits at https://coinrailz.com/credits

Supported Blockchains

• Ethereum
• Base
• Polygon
• BNB Chain (BSC)
• Arbitrum
• Optimism
• PulseChain

Contributing

Contributions welcome! Please open an issue or submit a PR.

Support

• Documentation: https://coinrailz.com/developers
• Issues: https://github.com/coinrailz/mcp-server-coinrailz/issues
• Email: support@coinrailz.com

License

MIT License - see LICENSE file