# TradeHouse Agent Data — MCP Quickstart

Read-only prediction-market history for your Claude or agent, over the
[Model Context Protocol](https://modelcontextprotocol.io). Cross-venue settled-market
metadata and settlement outcomes from **Kalshi, Polymarket, Polymarket US, and
Limitless** — derived from each venue's public API.

> This repo is a client quickstart (config + examples). The data service is hosted at
> **https://mcp.tradehouse.eliteaiempire.com**.

## Tools

| Tool | Example args | Returns |
|---|---|---|
| `list_venues` | `{}` | Venues covered + market/settled row counts |
| `fee_schedule` | `{"venue":"kalshi"}` | Public trading-fee schedule for a venue |
| `settled_history_stats` | `{"venue":"kalshi","months_back":12}` | Per-month settled counts, YES-settle rate, volume |
| `category_breakdown` | `{"venue":"kalshi","top_n":20}` | Top categories by settled count, YES-rate, avg volume |
| `market_lookup` | `{"venue":"kalshi","ticker":"INXD-26JUN12-T5500"}` | Metadata + settlement result for one market |

Venues: `kalshi`, `polymarket`, `polymarket_us`, `limitless`. Read-only — no order,
position, or execution surface.

## Get a free key (no card)

```bash
curl -s -X POST https://mcp.tradehouse.eliteaiempire.com/signup \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'
# -> {"token":"thmcp_...","tier":"free","daily_limit":100,"endpoint":"..."}
```

Save the token — it is shown once.

## Client config (`mcp.json` / Claude Desktop)

```json
{
  "mcpServers": {
    "tradehouse": {
      "url": "https://mcp.tradehouse.eliteaiempire.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
```

## Pricing

| Tier | Price | Daily limit |
|---|---|---|
| Free | $0 | 100 requests/day |
| Starter | $49/mo | 5,000 requests/day |
| Pro | $199/mo | 50,000 requests/day |

Paid tiers: [TradeHouse checkout](https://tradehouse.eliteaiempire.com).
Full docs: https://mcp.tradehouse.eliteaiempire.com/docs

---

Built by [Elite Agentic Solutions](https://eliteagenticsolutions.com) /
[TradeHouse](https://tradehouse.eliteaiempire.com). MIT licensed (this quickstart).