{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ay78jnxeyrvy","handle":"paperclob-mcp","url":"https://wellknown.network/agents/paperclob-mcp","links":{"self":"https://wellknown.network/agents/paperclob-mcp/record.json","html":"https://wellknown.network/agents/paperclob-mcp","markdown":"https://wellknown.network/agents/paperclob-mcp/record.md","api":"https://wellknown.network/api/v1/agents/paperclob-mcp","status":"https://wellknown.network/api/v1/agents/paperclob-mcp/status","claim":"https://wellknown.network/agents/paperclob-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/paperclob-mcp/claim.json","badge":"https://wellknown.network/agents/paperclob-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/paperclob-mcp/history","tools":"https://wellknown.network/api/v1/agents/paperclob-mcp/tools"},"ard":{"identifier":"urn:air::server:paperclob-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"paperclob-mcp","summary":"MCP server for PaperBook (paperclob.com) — Polymarket-compatible paper CLOB plus the honest simulator: recorded real tape, fillable-lens fills, founded verdicts.","description":"# paperclob-mcp\n\nMCP 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.\n\nEvery 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.\n\n## Install\n\n```sh\npip install paperclob-mcp\n```\n\n### Claude Code\n\n```sh\nclaude mcp add paperclob -- paperclob-mcp\n```\n\n### Claude Desktop (`claude_desktop_config.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"paperclob\": {\n      \"command\": \"paperclob-mcp\"\n    }\n  }\n}\n```\n\n## Tools\n\nLive paper CLOB (paper money — registering grants $10,000; no real funds):\n\n| tool | what it does |\n|---|---|\n| `list_markets` | Active crypto up/down markets (BTC/ETH/SOL/XRP/BNB/DOGE × 5m/15m) |\n| `get_leaderboard` | Paper-PnL ranking of registered bots |\n| `register_live_account(handle)` | Create an account; credentials stay inside the MCP process |\n| `place_live_order(market, outcome, side, size, order_type, price?)` | Taker or resting limit order |\n| `live_positions()` | Balance, positions, fills, resting orders |\n\nHonest simulator (recorded real tape, fillable-lens grading):\n\n| tool | what it does |\n|---|---|\n| `create_sim_session(t0, t1, coins?, durations?, latency_ms?, seed?)` | Mint a private replay session (corpus floor 2026-05-29) |\n| `advance_clock(sim_id, polls?, market?, until_end?)` | Step the virtual clock — nothing moves until polled, so lookahead is impossible |\n| `get_time(sim_id)` | Read the virtual clock |\n| `sim_markets(sim_id)` | Slots active at virtual time |\n| `sim_book(sim_id, market?)` | Top-of-book at virtual time (from the event stream) |\n| `place_sim_order(sim_id, market, outcome, side, size, order…","publisher":{"name":"PaperBook","url":null},"homepage":"https://paperclob.com/llms-full.txt","repository":null,"version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["backtesting","mcp","paper-trading","polymarket","prediction-markets","simulator","trading-bot"],"pricing":null,"endpoints":[{"url":"pypi:paperclob-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"derived"}],"categories":["finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"paperclob-mcp","registry":"pypi","observedAt":"2026-11-03T21:28:23.244Z","publishedAt":"2026-07-07T21:03:44.523089Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"paperclob-mcp","url":"https://pypi.org/project/paperclob-mcp/","firstSeenAt":"2026-09-10T09:25:27.540Z","fetchedAt":"2026-11-03T21:27:19.487Z","normalizedAt":"2026-11-03T21:27:19.487Z"}]},"firstSeenAt":"2026-09-10T09:25:27.540Z","updatedAt":"2026-11-03T21:28:23.244Z"}