{"_id":"@elcara-hq/resolvedmarkets-mcp","_rev":"2-205ca5fba797f6ff2f7bc50c2bc815c1","name":"@elcara-hq/resolvedmarkets-mcp","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@elcara-hq/resolvedmarkets-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","polymarket","orderbook","prediction-markets","claude","ai-agent","crypto","trading"],"author":{"name":"Elcara HQ"},"license":"MIT","_id":"@elcara-hq/resolvedmarkets-mcp@1.0.0","maintainers":[{"name":"elcara-hq","email":"haard@elcara.xyz"}],"homepage":"https://resolvedmarkets.com","bugs":{"url":"https://github.com/Elcara-HQ/HighFidelity_OrderbookTracker/issues"},"bin":{"rm-mcp":"dist/index.js"},"dist":{"shasum":"2035a1de194ab25d801b6c41ab7809afe990e838","tarball":"https://registry.npmjs.org/@elcara-hq/resolvedmarkets-mcp/-/resolvedmarkets-mcp-1.0.0.tgz","fileCount":12,"integrity":"sha512-hQUPj91luhhrVFmiXe9RGEYaTR/64uUm5DxkkGaD4fteXKe+CbxPQdQ0IcQNT0M4c9KdK0sj3GN4Da81CNbPxg==","signatures":[{"sig":"MEQCIHHpIuZ71e7Zs3owB35iHGrFUQYZtCtHcq7nwptMy/QmAiBdh3ZSEGXEvX9xZn56vS5BLWpkMS9o9HJOyC41n8T1Vw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19134},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"ef56a68f9f28f0d68f1ffbc0e6a1251ae61c4ae7","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"tsc"},"_npmUser":{"name":"elcara-hq","email":"haard@elcara.xyz"},"repository":{"url":"git+https://github.com/Elcara-HQ/HighFidelity_OrderbookTracker.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.8.0","description":"MCP server for Resolved Markets — connect Claude, GPT, or any AI agent to live Polymarket orderbook data. 6 tools + 2 resources.","directories":{},"_nodeVersion":"24.13.1","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","typescript":"^5.2.2","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/resolvedmarkets-mcp_1.0.0_1776790966099_0.31713375345618844","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@elcara-hq/resolvedmarkets-mcp","version":"1.1.0","description":"MCP server for Resolved Markets — connect Claude, GPT, or any AI agent to live & historical Polymarket prediction-market orderbook data (crypto, sports, economics, weather, social, equities) plus Hyperliquid perps. 12 tools + 2 resources.","type":"module","main":"dist/index.js","bin":{"rm-mcp":"dist/index.js"},"scripts":{"start":"node dist/index.js","dev":"tsx src/index.ts","build":"tsc","prepublishOnly":"tsc"},"keywords":["mcp","model-context-protocol","polymarket","orderbook","prediction-markets","claude","ai-agent","crypto","trading"],"publishConfig":{"registry":"https://registry.npmjs.org/","access":"public"},"repository":{"type":"git","url":"git+https://github.com/Elcara-HQ/HighFidelity_OrderbookTracker.git","directory":"packages/mcp-server"},"homepage":"https://resolvedmarkets.com","author":{"name":"Elcara HQ"},"license":"MIT","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.11.0","zod":"^3.22.0"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.7.0","typescript":"^5.2.2"},"gitHead":"1c5f4673f18388c06163924030b8be60f11c3dd5","types":"./dist/index.d.ts","_id":"@elcara-hq/resolvedmarkets-mcp@1.1.0","bugs":{"url":"https://github.com/Elcara-HQ/HighFidelity_OrderbookTracker/issues"},"_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-HGpi9q5eEdxSIu3QN2gukwYX57h3KlNEORSc9Tv4KG7xqKt8pe2c3M8f78T9VnDky2LyuEQf5A7E8g2iUvAUdA==","shasum":"042b227f5333bd6cf86a1b5fdaaa481d43e7e091","tarball":"https://registry.npmjs.org/@elcara-hq/resolvedmarkets-mcp/-/resolvedmarkets-mcp-1.1.0.tgz","fileCount":12,"unpackedSize":52458,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAv/2epgRTFjfOdyR+pXYaRQc/U5H3a9jMO3rj/5/bNZAiEAgmBChl9s2Cw+munu2Ufvhn9K9SkBcOjdpNXq+lpNp0M="}]},"_npmUser":{"name":"elcara-hq","email":"haard@elcara.xyz"},"directories":{},"maintainers":[{"name":"elcara-hq","email":"haard@elcara.xyz"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/resolvedmarkets-mcp_1.1.0_1779728066843_0.6153823095430546"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-21T17:02:45.993Z","modified":"2026-05-25T16:54:27.104Z","1.0.0":"2026-04-21T17:02:46.253Z","1.1.0":"2026-05-25T16:54:26.983Z"},"bugs":{"url":"https://github.com/Elcara-HQ/HighFidelity_OrderbookTracker/issues"},"author":{"name":"Elcara HQ"},"license":"MIT","homepage":"https://resolvedmarkets.com","keywords":["mcp","model-context-protocol","polymarket","orderbook","prediction-markets","claude","ai-agent","crypto","trading"],"repository":{"type":"git","url":"git+https://github.com/Elcara-HQ/HighFidelity_OrderbookTracker.git","directory":"packages/mcp-server"},"description":"MCP server for Resolved Markets — connect Claude, GPT, or any AI agent to live & historical Polymarket prediction-market orderbook data (crypto, sports, economics, weather, social, equities) plus Hyperliquid perps. 12 tools + 2 resources.","maintainers":[{"name":"elcara-hq","email":"haard@elcara.xyz"}],"readme":"# Resolved Markets MCP Server\n\n[MCP](https://modelcontextprotocol.io) server for [Resolved Markets](https://resolvedmarkets.com) — connect Claude, GPT, or any AI agent to live Polymarket prediction market orderbook data.\n\n## Two ways to use it\n\nBoth paths require **your own** Resolved Markets API key — get one at [resolvedmarkets.com/api-keys](https://resolvedmarkets.com/api-keys). Tier limits (free = BTC only + 24h + 60 rpm; Pro = all crypto + Hyperliquid + 500 rpm; Enterprise = everything + 3000 rpm) are applied server-side against the key's owner.\n\n### 1. Hosted (recommended) — `https://mcp.resolvedmarkets.com/mcp`\n\nConnect any MCP client at the hosted endpoint and **send your key in the `X-API-Key` HTTP header**. Each session is bound to its own key, so your tier and quota attach to your account, not anyone else's.\n\nBridge into Claude Desktop / Claude Code via [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):\n\n```json\n{\n  \"mcpServers\": {\n    \"resolvedmarkets\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\", \"mcp-remote\",\n        \"https://mcp.resolvedmarkets.com/mcp\",\n        \"--header\", \"X-API-Key: rm_your_api_key_here\"\n      ]\n    }\n  }\n}\n```\n\n`Authorization: Bearer rm_...` is also accepted if your client prefers it.\n\n**Security behaviour of the hosted endpoint:**\n\n- Requests without a key (or with a malformed key) are rejected with `401` before a session is opened.\n- The key is re-validated on **every** request using a constant-time comparison — a request that arrives on an existing session with a missing or mismatched key is rejected as a hijack attempt (and logged operator-side).\n- Sessions auto-expire **30 minutes** after `initialize`. After that your client must re-initialize and present its key again. `mcp-remote` handles this transparently — it forwards `--header` on every request and re-initializes when a session is rejected.\n\nBest for the common case — zero npm install, you get the production-deployed MCP version, billing/quota goes to your account.\n\n### 2. Self-hosted / local (npm install)\n\nRun the npm package locally. The local stdio process reads the key once from the `HF_API_KEY` env var. Best if you want fully-offline tooling or you're building a multi-tenant agent that handles keys itself.\n\n#### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"resolvedmarkets\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@elcara-hq/resolvedmarkets-mcp\"],\n      \"env\": {\n        \"HF_API_URL\": \"https://api.resolvedmarkets.com\",\n        \"HF_API_KEY\": \"rm_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Claude Code\n\n```bash\nclaude mcp add resolvedmarkets -- npx -y @elcara-hq/resolvedmarkets-mcp\nexport HF_API_KEY=rm_your_api_key_here\n```\n\n#### One-off via npx\n\n```bash\nHF_API_KEY=rm_your_api_key_here npx @elcara-hq/resolvedmarkets-mcp\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_categories` | Discover all tracked categories (crypto, sports, economics, weather, social, equities) with market counts |\n| `list_markets` | List currently-live markets, optionally filtered by category/subcategory |\n| `list_historical_markets` | List closed/past markets — `recent` (paginated) or `full` (everything ever stored) |\n| `get_market` | Resolve a market by slug (e.g. `btc-updown-5m`) into its conditionId + metadata |\n| `get_orderbook` | Live orderbook (bid/ask arrays, spread, depth) by conditionId **or** slug |\n| `get_market_summary` | 7-day aggregated stats (price range, spreads, per-side breakdown) |\n| `get_snapshot` | Historical orderbook state at a specific timestamp |\n| `get_latest_snapshots` | The 5 most recent snapshots — data-freshness check |\n| `query_snapshots` | Paginated time-series of snapshots for one market (the core analysis tool) |\n| `get_exchange_orderbook` | Live Hyperliquid perp orderbook (BTC/ETH/SOL/XRP) — Pro+ |\n| `get_exchange_snapshots` | Historical Hyperliquid perp snapshots — Pro+ |\n| `get_system_stats` | System-wide stats (live markets, snapshot throughput, crypto prices) |\n\nTier limits are enforced server-side (free tier = BTC only, 24h history). When a\ncall fails on a tier/permission limit the tool returns a structured hint plus the\nHTTP status so the agent can explain the limit and suggest an upgrade.\n\n## Resources\n\n| URI | Description |\n|-----|-------------|\n| `markets://live` | Currently active markets with token IDs and metadata |\n| `prices://latest` | Current cryptocurrency prices and dataset/exchange stats |\n\n## Environment Variables\n\nOnly used for the **self-hosted/local** install (option 2 above). The hosted endpoint at `mcp.resolvedmarkets.com` doesn't need any of these.\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `HF_API_URL` | `http://localhost:3001` | Backend API URL. Use `https://api.resolvedmarkets.com` for production. |\n| `HF_API_KEY` | — | Your API key (`rm_...`). Get one at [resolvedmarkets.com/api-keys](https://resolvedmarkets.com/api-keys). Required for authenticated tools; the backend enforces tier/limits against this key's owner. |\n| `MCP_TRANSPORT` | `stdio` | Transport mode: `stdio` or `http` |\n| `MCP_PORT` | `3002` | HTTP port (when using HTTP transport) |\n\n## Example Queries\n\nOnce connected, ask your AI agent:\n\n- \"What market categories does Resolved Markets track?\"\n- \"What BTC prediction markets are live right now?\"\n- \"Show me the live orderbook for `btc-updown-5m`\"\n- \"What was the BTC 5m spread around 2026-03-02 10:42 UTC?\"\n- \"Pull the last 500 snapshots for that market and analyze the spread trend\"\n- \"Compare the Polymarket BTC price to the Hyperliquid BTC perp\"\n- \"How's the data pipeline performing?\"\n\n## HTTP Transport\n\nFor remote integrations or custom agents:\n\n```bash\nMCP_TRANSPORT=http MCP_PORT=3002 npx @elcara-hq/resolvedmarkets-mcp\n```\n\nEndpoint: `POST http://localhost:3002/mcp`\n\n## Links\n\n- [Website](https://resolvedmarkets.com)\n- [API Docs](https://resolvedmarkets.com/docs)\n- [CLI Tool](https://www.npmjs.com/package/@elcara-hq/resolvedmarkets-cli)\n","readmeFilename":"README.md"}