API for Chads README

{
  "mcpServers": {
    "apiforchads": {
      "url": "https://mcp.apiforchads.com/mcp"
    }
  }
}

{
  "apiforchads": {
    "url": "https://mcp.apiforchads.com/mcp"
  }
}

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client("https://mcp.apiforchads.com/mcp") as (r, w, _):
    async with ClientSession(r, w) as session:
        await session.initialize()

        # Get BTC price
        result = await session.call_tool("get_crypto_price", {"asset": "BTC"})
        print(result)  # {"chainlink_price": 65920.45, "binance_price": 65935.12, ...}

# With API key
curl -H "Authorization: Bearer YOUR_KEY" \
  https://price.apiforchads.com/v1/prices/BTC

# Response
{
  "asset": "BTC",
  "chainlink_price": 65920.45,
  "binance_price": 65935.12,
  "chainlink_age_seconds": 13,
  "timestamp": 1771833021
}

curl -H "Authorization: Bearer YOUR_KEY" \
  https://price.apiforchads.com/v1/clob/will-trump-deport-less-than-250000

# Response
{
  "market_slug": "will-trump-deport-less-than-250000",
  "best_bid": 0.42,
  "best_ask": 0.44,
  "spread": 0.02,
  "mid_price": 0.43
}

curl -X POST -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  https://research.apiforchads.com/v1/research \
  -d '{"query": "What are the latest Bitcoin ETF inflows?", "tier": "quick"}'

# Returns job_id — poll /v1/research/status/{job_id} for results

curl -X POST -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  https://render.apiforchads.com/v1/render \
  -d '{"url": "https://polymarket.com", "format": "markdown", "max_chars": 5000}'

curl -X POST -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  https://render.apiforchads.com/v1/render/screenshot \
  -d '{"url": "https://example.com", "full_page": true}' \
  --output screenshot.png

from apiforchads import Client

client = Client(api_key="YOUR_KEY")

btc = client.price("BTC")
print(f"BTC: ${btc.chainlink_price:,.2f}")

market = client.clob("will-trump-deport-less-than-250000")
print(f"Bid: {market.best_bid} Ask: {market.best_ask}")

report = client.research("Latest crypto regulations", tier="quick")
print(report.text)

curl -H "Authorization: Bearer YOUR_KEY" https://price.apiforchads.com/v1/prices/BTC

                    ┌─────────────────────┐
                    │   Cloudflare Edge    │
                    │   (SSL + routing)    │
                    └──────────┬──────────┘
                               │
              ┌────────────────┼────────────────┐
              │                │                │
    ┌─────────┴──┐   ┌────────┴───┐   ┌────────┴───┐
    │ Price API  │   │ Research   │   │ Render API │
    │ :8100      │   │ API :8101  │   │ :8102      │
    │            │   │            │   │            │
    │ • Chainlink│   │ • Gemini   │   │ • Playwright│
    │ • Binance  │   │ • Google   │   │ • Chromium  │
    │ • CLOB     │   │ • Search   │   │ • SSRF prot │
    └────────────┘   └────────────┘   └────────────┘
              │                │                │
              └────────────────┼────────────────┘
                               │
                    ┌──────────┴──────────┐
                    │   MCP Server :8103  │
                    │   (tool discovery)  │
                    └─────────────────────┘

git clone https://github.com/chadbot0x/apiforchads-mcp.git
cd apiforchads-mcp

# Install dependencies
pip install mcp httpx

# Run the MCP server (connects to public APIs by default)
python server.py