polymarket-toolkit-mcp 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +51 -0
- package/dist/cli.js +994 -0
- package/dist/server.js +21303 -0
- package/docs/data/polymarket-api-rate-limits.json +40 -0
- package/package.json +51 -0
package/README.md
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# polymarket-toolkit-mcp
|
|
2
|
+
|
|
3
|
+
MCP server exposing [polymarket-toolkit](https://github.com/runesleo/polymarket-toolkit)'s
|
|
4
|
+
**read-only** Polymarket data CLI as [Model Context Protocol](https://modelcontextprotocol.io)
|
|
5
|
+
tools for AI agents. No keys, no orders — data only.
|
|
6
|
+
|
|
7
|
+
## Quick start
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
claude mcp add polymarket-toolkit -- npx -y polymarket-toolkit-mcp
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Generic MCP client config:
|
|
14
|
+
|
|
15
|
+
```json
|
|
16
|
+
{
|
|
17
|
+
"mcpServers": {
|
|
18
|
+
"polymarket-toolkit": {
|
|
19
|
+
"command": "npx",
|
|
20
|
+
"args": ["-y", "polymarket-toolkit-mcp"]
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Tools (10, all read-only)
|
|
27
|
+
|
|
28
|
+
| Tool | What it answers |
|
|
29
|
+
|---|---|
|
|
30
|
+
| `pm_profile` | PnL + open positions snapshot for an address/username |
|
|
31
|
+
| `pm_activity` | Recent trades for an address/username |
|
|
32
|
+
| `pm_brier` | Prediction-quality (Brier) score from settled positions |
|
|
33
|
+
| `pm_pnl_check` | Fee-inclusive PnL cross-check vs leaderboard |
|
|
34
|
+
| `pm_scan` | Active markets ranked by 24h volume + spread |
|
|
35
|
+
| `pm_updown` | Crypto up/down market fields for an event slug |
|
|
36
|
+
| `pm_leaderboard` | Profit leaderboard snapshot |
|
|
37
|
+
| `pm_redeem_watchdog` | Redeemable positions for an address (no signing) |
|
|
38
|
+
| `pm_v2_check` | V2 CTF readiness diagnostics |
|
|
39
|
+
| `pm_rate_limits` | Known Polymarket API rate limits (offline) |
|
|
40
|
+
|
|
41
|
+
## Security model
|
|
42
|
+
|
|
43
|
+
- Every tool shells out to the toolkit's `pm` CLI (argv array, no shell) — the server can do
|
|
44
|
+
exactly what the read-only CLI can do, nothing more.
|
|
45
|
+
- Inputs are allowlist-validated twice (MCP SDK layer + independent handler re-validation).
|
|
46
|
+
- Subprocess guards: 60s timeout, 2MB output cap, concurrency limit.
|
|
47
|
+
- **No trading over MCP** — order placement lives in the toolkit's separate opt-in
|
|
48
|
+
[`executor/`](https://github.com/runesleo/polymarket-toolkit/tree/main/executor) package,
|
|
49
|
+
human-wired only.
|
|
50
|
+
|
|
51
|
+
Full docs: [docs/mcp.md](https://github.com/runesleo/polymarket-toolkit/blob/main/docs/mcp.md)
|