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

C

... View full README on GitHub