tradehouse-mcp-quickstart/README.md
Empire OSS be628897bd TradeHouse MCP quickstart: README + mcp.json client config
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 22:29:30 +00:00

62 lines
2.1 KiB
Markdown

# 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).