From be628897bd8f291e1220c954bffa0456a66e55bf Mon Sep 17 00:00:00 2001
From: Empire OSS <oss@eliteaiempire.com>
Date: Fri, 12 Jun 2026 22:29:30 +0000
Subject: [PATCH] TradeHouse MCP quickstart: README + mcp.json client config

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 mcp.json  |  9 ++++++++
 2 files changed, 70 insertions(+), 2 deletions(-)
 create mode 100644 mcp.json

diff --git a/README.md b/README.md
index d0b83f2..b501822 100644
--- a/README.md
+++ b/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.
\ No newline at end of file
+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).
diff --git a/mcp.json b/mcp.json
new file mode 100644
index 0000000..3aecb49
--- /dev/null
+++ b/mcp.json
@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "tradehouse": {
+      "type": "http",
+      "url": "https://mcp.tradehouse.eliteaiempire.com/mcp",
+      "headers": { "Authorization": "Bearer thmcp_YOUR_FREE_KEY" }
+    }
+  }
+}