{"title":"Coin Railz MCP Integration Guide","version":"1.0.0","audience":"Developers building MCP servers, LLM agent frameworks, or tool plugins that call Coin Railz services.","summary":"If you are building an MCP wrapper for Coin Railz and are stuck at the payment step: skip on-chain complexity entirely. Use Path A (API key credits) to get paid access in under 60 seconds.","paths":{"pathA":{"label":"Path A — API Key Credits (Fastest, no crypto required)","steps":[{"step":1,"action":"Get your free trial key","method":"GET","endpoint":"https://coinrailz.com/api/m2m/credits/trial","curl":"curl https://coinrailz.com/api/m2m/credits/trial","response":{"apiKey":"cr_live_...","credits":5,"expiresIn":"7 days"},"note":"SAVE the apiKey — returned once only. $5 credit, good for ~80–100 calls."},{"step":2,"action":"Call any service with your key","method":"POST","endpoint":"https://coinrailz.com/x402/{serviceId}","curl":"curl -X POST https://coinrailz.com/x402/gas-price-oracle -H 'X-API-KEY: cr_live_...' -H 'Content-Type: application/json' -d '{}'","billingHeaders":{"X-Credits-Used":"credits deducted for this call","X-Credits-Remaining":"your remaining balance","X-Recharge-Url":"link to buy more credits"}},{"step":3,"action":"Buy more credits when trial runs out","method":"POST","endpoint":"https://coinrailz.com/api/m2m/credits/checkout/session","curl":"curl -X POST https://coinrailz.com/api/m2m/credits/checkout/session -H 'Content-Type: application/json' -d '{\"amount\": 10}'","note":"Returns a Stripe hosted checkout URL. Complete in browser. API key is auto-provisioned within ~60s of payment."}]},"pathB":{"label":"Path B — Native x402 On-Chain USDC (for crypto-native agents)","description":"Standard x402 protocol (EIP-7615). Call endpoint → receive 402 challenge → construct payment header → retry with payment.","steps":[{"step":1,"action":"Call any x402 endpoint — receive 402 challenge","curl":"curl -X POST https://coinrailz.com/x402/gas-price-oracle -H 'Content-Type: application/json' -d '{}'","response402":{"status":402,"headers":{"WWW-Authenticate":"Payment ..."}}},{"step":2,"action":"Parse challenge, construct X-Payment header","note":"Use the x402 SDK: https://github.com/coinbase/x402 or Dexter at https://dexter.cash","sdks":{"typescript":"npm install x402","python":"pip install x402"}},{"step":3,"action":"Retry with payment header","curl":"curl -X POST https://coinrailz.com/x402/gas-price-oracle -H 'Content-Type: application/json' -H 'X-Payment: <base64-payload>' -d '{}'","facilitators":["cdp.coinbase.com","dexter.cash"]}]}},"serviceDiscovery":{"catalog":"https://coinrailz.com/x402/catalog","mcpServices":"https://coinrailz.com/mcp/services","openapi":"https://coinrailz.com/openapi.json"},"mcpServiceMap":[{"mcpTool":"ping","serviceId":"ping","endpoint":"https://coinrailz.com/x402/ping","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"first_call","serviceId":"first-call","endpoint":"https://coinrailz.com/x402/first-call","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"trade_signals","serviceId":"trade-signals","endpoint":"https://coinrailz.com/x402/trade-signals","priceUsd":0.75,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"wallet_risk","serviceId":"wallet-risk","endpoint":"https://coinrailz.com/x402/wallet-risk","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"token_sentiment","serviceId":"token-sentiment","endpoint":"https://coinrailz.com/x402/token-sentiment","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"whale_alerts","serviceId":"whale-alerts","endpoint":"https://coinrailz.com/x402/whale-alerts","priceUsd":0.35,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"trending_tokens","serviceId":"trending-tokens","endpoint":"https://coinrailz.com/x402/trending-tokens","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"sentiment_analysis","serviceId":"sentiment-analysis","endpoint":"https://coinrailz.com/x402/sentiment-analysis","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"dex_liquidity","serviceId":"dex-liquidity","endpoint":"https://coinrailz.com/x402/dex-liquidity","priceUsd":0.2,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"contract_scan","serviceId":"contract-scan","endpoint":"https://coinrailz.com/x402/contract-scan","priceUsd":1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"portfolio_optimization","serviceId":"portfolio-optimization","endpoint":"https://coinrailz.com/x402/portfolio-optimization","priceUsd":2,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"token_price","serviceId":"token-price","endpoint":"https://coinrailz.com/x402/token-price","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"portfolio_tracker","serviceId":"portfolio-tracker","endpoint":"https://coinrailz.com/x402/portfolio-tracker","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"multi_chain_balance","serviceId":"multi-chain-balance","endpoint":"https://coinrailz.com/x402/multi-chain-balance","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"arbitrage_scanner","serviceId":"arbitrage-scanner","endpoint":"https://coinrailz.com/x402/arbitrage-scanner","priceUsd":1.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"gas_price_oracle","serviceId":"gas-price-oracle","endpoint":"https://coinrailz.com/x402/gas-price-oracle","priceUsd":0.1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"transaction_builder","serviceId":"transaction-builder","endpoint":"https://coinrailz.com/x402/transaction-builder","priceUsd":0.3,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"batch_quote","serviceId":"batch-quote","endpoint":"https://coinrailz.com/x402/batch-quote","priceUsd":0.4,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"seamless_chain_bridge","serviceId":"seamless-chain-bridge","endpoint":"https://coinrailz.com/x402/seamless-chain-bridge","priceUsd":2,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"smart_contract_audit","serviceId":"smart-contract-audit","endpoint":"https://coinrailz.com/x402/smart-contract-audit","priceUsd":10,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"trading_signal","serviceId":"trading-signal","endpoint":"https://coinrailz.com/x402/trading-signal","priceUsd":1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"payment_processing","serviceId":"payment-processing","endpoint":"https://coinrailz.com/x402/payment-processing","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"verified_agent_identity","serviceId":"verified-agent-identity","endpoint":"https://coinrailz.com/x402/verified-agent-identity","priceUsd":5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"compliance_consultation","serviceId":"compliance-consultation","endpoint":"https://coinrailz.com/x402/compliance-consultation","priceUsd":5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"agent_create_wallet","serviceId":"agent-create-wallet","endpoint":"https://coinrailz.com/x402/agent-create-wallet","priceUsd":2,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"property_valuation","serviceId":"property-valuation","endpoint":"https://coinrailz.com/x402/property-valuation","priceUsd":0.75,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"lease_analysis","serviceId":"lease-analysis","endpoint":"https://coinrailz.com/x402/lease-analysis","priceUsd":1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"construction_progress","serviceId":"construction-progress","endpoint":"https://coinrailz.com/x402/construction-progress","priceUsd":1.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"rwa_nav_oracle","serviceId":"rwa-nav-oracle","endpoint":"https://coinrailz.com/x402/rwa-nav-oracle","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"tokenized_yield_compare","serviceId":"tokenized-yield-compare","endpoint":"https://coinrailz.com/x402/tokenized-yield-compare","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"credit_risk_score","serviceId":"credit-risk-score","endpoint":"https://coinrailz.com/x402/credit-risk-score","priceUsd":1.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"compliance_check","serviceId":"compliance-check","endpoint":"https://coinrailz.com/x402/compliance-check","priceUsd":1.75,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"fraud_detection","serviceId":"fraud-detection","endpoint":"https://coinrailz.com/x402/fraud-detection","priceUsd":0.75,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"risk_metrics","serviceId":"risk-metrics","endpoint":"https://coinrailz.com/x402/risk-metrics","priceUsd":1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"instant_agent_wallet","serviceId":"instant-agent-wallet","endpoint":"https://coinrailz.com/x402/instant-agent-wallet","priceUsd":1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"token_metadata","serviceId":"token-metadata","endpoint":"https://coinrailz.com/x402/token-metadata","priceUsd":0.1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"correlation_matrix","serviceId":"correlation-matrix","endpoint":"https://coinrailz.com/x402/correlation-matrix","priceUsd":0.75,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"approval_manager","serviceId":"approval-manager","endpoint":"https://coinrailz.com/x402/approval-manager","priceUsd":0.2,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"polymarket_odds","serviceId":"polymarket-odds","endpoint":"https://coinrailz.com/x402/polymarket-odds","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"polymarket_events","serviceId":"polymarket-events","endpoint":"https://coinrailz.com/x402/polymarket-events","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"polymarket_search","serviceId":"polymarket-search","endpoint":"https://coinrailz.com/x402/polymarket-search","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"prediction_market_odds","serviceId":"prediction-market-odds","endpoint":"https://coinrailz.com/x402/prediction-market-odds","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"kalshi_markets","serviceId":"kalshi-markets","endpoint":"https://coinrailz.com/x402/kalshi-markets","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"kalshi_odds","serviceId":"kalshi-odds","endpoint":"https://coinrailz.com/x402/kalshi-odds","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"kalshi_search","serviceId":"kalshi-search","endpoint":"https://coinrailz.com/x402/kalshi-search","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"prediction_market_spread","serviceId":"prediction-market-spread","endpoint":"https://coinrailz.com/x402/prediction-market-spread","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"stock_sentiment","serviceId":"stock-sentiment","endpoint":"https://coinrailz.com/x402/stock-sentiment","priceUsd":0.4,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"forex_sentiment","serviceId":"forex-sentiment","endpoint":"https://coinrailz.com/x402/forex-sentiment","priceUsd":0.4,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"solana_yield_finder","serviceId":"solana-yield-finder","endpoint":"https://coinrailz.com/x402/solana-yield-finder","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"sdk_payments_evm","serviceId":"sdk-payments-evm","endpoint":"https://coinrailz.com/api/sdk/payments/send","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"sdk_payments_solana","serviceId":"sdk-payments-solana","endpoint":"https://coinrailz.com/api/sdk/solana/payments/send","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"fire_alerts","serviceId":"fire-alerts","endpoint":"https://coinrailz.com/api/satellite/fire-alerts","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"weather_imagery","serviceId":"weather-imagery","endpoint":"https://coinrailz.com/api/satellite/weather-imagery","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"vegetation","serviceId":"vegetation","endpoint":"https://coinrailz.com/api/satellite/vegetation","priceUsd":0.1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"flood_detection","serviceId":"flood-detection","endpoint":"https://coinrailz.com/api/satellite/flood-detection","priceUsd":0.1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"air_quality","serviceId":"air-quality","endpoint":"https://coinrailz.com/api/satellite/air-quality","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"land_use","serviceId":"land-use","endpoint":"https://coinrailz.com/api/satellite/land-use","priceUsd":0.15,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"earthdata_granules","serviceId":"earthdata-granules","endpoint":"https://coinrailz.com/x402/earthdata-granules","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"earthdata_precipitation","serviceId":"earthdata-precipitation","endpoint":"https://coinrailz.com/x402/earthdata-precipitation","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"earthdata_sst","serviceId":"earthdata-sst","endpoint":"https://coinrailz.com/x402/earthdata-sst","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"earthdata_soil_moisture","serviceId":"earthdata-soil-moisture","endpoint":"https://coinrailz.com/x402/earthdata-soil-moisture","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"earthdata_ocean_color","serviceId":"earthdata-ocean-color","endpoint":"https://coinrailz.com/x402/earthdata-ocean-color","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"satellite_earthdata","serviceId":"satellite-earthdata","endpoint":"https://coinrailz.com/x402/satellite-earthdata","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"fleet_telematics","serviceId":"fleet-telematics","endpoint":"https://coinrailz.com/x402/fleet-telematics","priceUsd":0.1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"weather_station_data","serviceId":"weather-station-data","endpoint":"https://coinrailz.com/x402/weather-station-data","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"iot_sensor_reading","serviceId":"iot-sensor-reading","endpoint":"https://coinrailz.com/x402/iot-sensor-reading","priceUsd":0.025,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"iot_device_stream","serviceId":"iot-device-stream","endpoint":"https://coinrailz.com/x402/iot-device-stream","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"iot_bulk_data","serviceId":"iot-bulk-data","endpoint":"https://coinrailz.com/x402/iot-bulk-data","priceUsd":0.5,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"ai_inference","serviceId":"ai-inference","endpoint":"https://coinrailz.com/x402/ai-inference","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"b20_token_info","serviceId":"b20-token-info","endpoint":"https://coinrailz.com/x402/b20-token-info","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"b20_transfer_check","serviceId":"b20-transfer-check","endpoint":"https://coinrailz.com/x402/b20-transfer-check","priceUsd":0.1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"b20_compliance_scan","serviceId":"b20-compliance-scan","endpoint":"https://coinrailz.com/x402/b20-compliance-scan","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"vlt_usdc_deposit","serviceId":"vlt-usdc-deposit","endpoint":"https://coinrailz.com/x402/vlt-usdc-deposit","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"vlt_usdc_withdraw","serviceId":"vlt-usdc-withdraw","endpoint":"https://coinrailz.com/x402/vlt-usdc-withdraw","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"vlt_usdc_zap_withdraw","serviceId":"vlt-usdc-zap-withdraw","endpoint":"https://coinrailz.com/x402/vlt-usdc-zap-withdraw","priceUsd":0.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"vlt_stats","serviceId":"vlt-stats","endpoint":"https://coinrailz.com/x402/vlt-stats","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"rh_stock_price","serviceId":"rh-stock-price","endpoint":"https://coinrailz.com/x402/rh-stock-price","priceUsd":0.05,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"rh_bridge_usdc","serviceId":"rh-bridge-usdc","endpoint":"https://coinrailz.com/x402/rh-bridge-usdc","priceUsd":0.75,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"instant_api_key","serviceId":"instant-api-key","endpoint":"https://coinrailz.com/x402/instant-api-key","priceUsd":1,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"robinhood_token_price","serviceId":"robinhood-token-price","endpoint":"https://coinrailz.com/x402/robinhood-token-price","priceUsd":0.6,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"robinhood_dex_pools","serviceId":"robinhood-dex-pools","endpoint":"https://coinrailz.com/x402/robinhood-dex-pools","priceUsd":1.25,"method":"POST","inputSchema":{"type":"object","properties":{}}},{"mcpTool":"robinhood_chain_stats","serviceId":"robinhood-chain-stats","endpoint":"https://coinrailz.com/x402/robinhood-chain-stats","priceUsd":0.75,"method":"POST","inputSchema":{"type":"object","properties":{}}}],"support":{"email":"support@coinrailz.com","humanGuide":"https://coinrailz.com/mcp-integration-guide"}}