TradeHouse MCP quickstart: README + mcp.json client config

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

README.md

@@ -1,3 +1,62 @@
-# tradehouse-mcp-quickstart
+# TradeHouse Agent Data — MCP Quickstart
 
-Read-only prediction-market history over MCP — client quickstart. Free tier, no card.
+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).

mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "tradehouse": {
+      "type": "http",
+      "url": "https://mcp.tradehouse.eliteaiempire.com/mcp",
+      "headers": { "Authorization": "Bearer thmcp_YOUR_FREE_KEY" }
+    }
+  }
+}