README.md
Access 41 Coin Railz x402 micropayment services for blockchain and crypto data
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-oracleandtoken-metadataare 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
- Visit https://coinrailz.com/credits
- Purchase credits with Stripe (credit card) or USDC
- Generate an API key
- Set the
COINRAILZ_API_KEYenvironment 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 |
Tools (5)
get_gas_pricesGet real-time gas prices across 6 chainsget_token_priceGet real-time DEX prices for tokensget_whale_alertsGet alerts for large blockchain transactionsscan_smart_contractPerform a security audit on a smart contractget_polymarket_oddsGet current odds for prediction market eventsEnvironment Variables
COINRAILZ_API_KEYrequiredAPI key for accessing Coin Railz servicesConfiguration
claude_desktop_config.json
{"mcpServers": {"coinrailz": {"command": "python", "args": ["-m", "coinrailz_mcp"], "env": {"COINRAILZ_API_KEY": "your-api-key-here"}}}}Try it
→What are the current gas prices across major chains?
→Check the latest whale alerts for large transactions.
→Perform a security audit on this smart contract address.
→What are the current odds for the upcoming Polymarket events?
→Analyze the current market sentiment for Ethereum.