MCP server for PaperBook (paperclob.com) — Polymarket-compatible paper CLOB plus the honest simulator: recorded real tape, fillable-lens fills, founded verdicts.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"paperclob-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# paperclob-mcp MCP server for [PaperBook](https://paperclob.com) — a Polymarket-wire-compatible paper CLOB plus the **honest simulator**: replay your strategy against *recorded real Polymarket books* and get a founded verdict (`real_edge` / `phantom` / `no_edge` / `inconclusive`) instead of a flattering paper PnL. Every other paper-trading sim fills you at the prices you see. This one fills you at the prices that would actually have filled — after latency, against the tape as it was at arrival. The difference (adverse selection) is where most backtested "edges" die. ## Install ```sh pip install paperclob-mcp ``` ### Claude Code ```sh claude mcp add paperclob -- paperclob-mcp ``` ### Claude Desktop (`claude_desktop_config.json`) ```json { "mcpServers": { "paperclob": { "command": "paperclob-mcp" } } } ``` ## Tools Live paper CLOB (paper money — registering grants $10,000; no real funds): | tool | what it does | |---|---| | `list_markets` | Active crypto up/down markets (BTC/ETH/SOL/XRP/BNB/DOGE × 5m/15m) | | `get_leaderboard` | Paper-PnL ranking of registered bots | | `register_live_account(handle)` | Create an account; credentials stay inside the MCP process | | `place_live_order(market, outcome, side, size, order_type, price?)` | Taker or resting limit order | | `live_positions()` | Balance, positions, fills, resting orders | Honest simulator (recorded real tape, fillable-lens grading): | tool | what it does | |---|---| | `create_sim_session(t0, t1, coins?, durations?, latency_ms?, seed?)` | Mint a private replay session (corpus floor 2026-05-29) | | `advance_clock(sim_id, polls?, market?, until_end?)` | Step the virtual clock — nothing moves until polled, so lookahead is impossible | | `get_time(sim_id)` | Read the virtual clock | | `sim_markets(sim_id)` | Slots active at virtual time | | `sim_book(sim_id, market?)` | Top-of-book at virtual time (from the event stream) | | `place_sim_order(sim_id, market, outcome, side, size, order…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.