Polymarket toolkit for DeepSeek Harness and Claude Code: market-data tools for Gamma/CLOB/Data-API (31 model tools in DSH; read-only subset exposed over MCP), opt-in authenticated trading tools, WebSocket stream service, and an embedded Polymarket knowhow skill.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:fashionmascherine-svg/dsh-polymarket-knowhow
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
A DeepSeek Harness plugin that gives your agent complete, verified Polymarket superpowers: live market-data tools across every Polymarket API (Gamma, CLOB, Data API, Perps, Combos/RFQ, Bridge), opt-in authenticated trading tools, a WebSocket market-stream service, and a bundled knowhow skill distilled from the official docs — so the model never hallucinates endpoints, parameters or auth flows.
Built on the knowledge base of atompilot/polymarket-skill (MIT) and re-verified against the current official OpenAPI specs and live API responses.
Why this plugin
| This plugin | Raw docs / MCP servers | |
|---|---|---|
Works offline for knowhow (bundled skill + polymarket_knowledge tool) |
✅ | ❌ |
| Live tools with typed schemas and bounded output | ✅ | partial |
| Covers auth flow end-to-end (L1 EIP-712 → L2 HMAC → builder headers) | ✅ | partial |
| New 2026 surfaces: Perps (56 ops) and Combos/RFQ | ✅ documented + read tools | scattered |
Endpoint drift corrected (volume24hr sorts, flat batch payloads, geoblock host, contract moves) |
✅ live-verified | ❌ |
Capabilities
Four independent Cordis rows (disable any of them by id in a later patch layer):
| Row id | Provides |
|---|---|
polymarket-service |
ctx.polymarket service: one configured client per Polymarket API (Gamma, CLOB, Data, Perps, RFQ, Bridge, Relayer) with timeout/retry/geoblock-aware HTTP |
polymarket-tools |
~25 always-on market-data tools + opt-in account/trading tools + Perps tools + polymarket_knowledge |
polymarket-skills |
Embedded runtime skill polymarket (16 knowledge modules as resources) via ctx.skills |
polymarket-stream |
Optional market-channel WebSocket bridge emitting polymarket/market-event Cordis events |
Model tools (always registered)
- Discovery:
polymarket_search,polymarket_events_list(offset + keyset pagination),polymarket_event_get,polymarket_markets_list,polymarket_market_get,polymarket_tags_list - CLOB data:
polymarket_orderbook(single/batch),polymarket_price(single/batch),polymarket_quote(mid+spread+last in one call),polymarket_price_history,polymarket_token_info(tick size, neg-risk, token→market resolution) - Data API v2:
polymarket_positions(status lifecycle + cursor pagination),polymarket_trades_public,polymarket_activity,polymarket_holders,polymarket_leaderboard,polymarket_open_interest,polymarket_live_volume,polymarket_portfolio_value,polymarket_user_stats,polymarket_resolutions,polymarket_approvals - Meta:
polymarket_geoblock_check,polymarket_combo_markets,polymarket_knowledge
Opt-in tools (registered only when configured)
trading.enabled+ L2 credentials →polymarket_account_orders,polymarket_account_trades,polymarket_cancel_orders,polymarket_balance_allowance,polymarket_heartbeat,polymarket_api_keys,polymarket_place_order*perps.enabled+ perps credentials →polymarket_perps_market_data,polymarket_perps_account
* Order placement signs through the official unified @polymarket/client SDK when it is resolvable (see Trading setup) — it supports both V1 CTF token ids and Protocol V2 position ids. Everything else uses zero-dependency Node crypto.
Install
# From GitHub (pin a commit for reproducibility)
dsh plugin --profile my-profile add github:fashionmascherine-svg/dsh-polymarket-knowhow#<sha>
# From a local checkout
dsh plugin --profile my-profile add ./dsh-polymarket-knowhow
# From a tarball
pnpm pack && dsh plugin --profile my-profile add ./dsh-polymarket-knowhow-0.3.0.tgz
The package ships a self-contained prepare build. A git install fetches sources, so pnpm ≥10 asks you to allow the build once — copy the package key pnpm prints into your profile's pnpm-workspace.yaml:
allowBuilds:
dsh-polymarket-knowhow: true
Then boot: dsh --profile my-profile. All four rows activate; only safe read-only tools are visible unless you enable trading/perps.
Use in Claude Code
The same repository is also a Claude Code plugin. It bundles:
- the
polymarketskill — the 15 knowledge modules underskills/polymarket/references/(generated fromknowledge/, single source of truth); - a read-only MCP server (
scripts/mcp-server.mjs) exposing the live market-data tools (search, events, orderbook, prices, quote, price history, positions, trades, leaderboard, open interest, perps market data, …). Trading/account tools are never exposed — the server is built with credentials resolution disabled and a denylist guard on top.
Install from this repo's bundled marketplace:
/plugin marketplace add fashionmascherine-svg/dsh-polymarket-knowhow
/plugin install polymarket-knowhow@fashionmascherine-svg-polymarket
Or attach just the MCP server to any MCP client:
claude mcp add polymarket-knowhow -- node /path/to/dsh-polymarket-knowhow/scripts/mcp-server.mjs
The prebuilt lib/ is committed, so both paths work out of the box; after touching src/ run npm run build and commit the rebuilt lib/. After editing knowledge/*.md regenerate the skill copies with npm run sync:claude-skill.
Configuration
Defaults are sensible (public endpoints, no credentials, trading off). Override any field from your profile's cordis.patch.yml:
- id: polymarket-service
config:
timeoutMs: 20000
maxRetries: 3
trading:
enabled: true
# Explicit creds… (or leave empty to read POLY_API_KEY / POLY_SECRET /
# POLY_PASSPHRASE / POLY_ADDRESS from the environment)
apiKey: ''
secret: ''
passphrase: ''
address: '' # funder/proxy wallet address
signatureType: 2 # 0 EOA · 1 POLY_PROXY · 2 GNOSIS_SAFE
perps:
enabled: false # reads POLYMARKET_PROXY / POLYMARKET_SECRET env
stream:
enabled: false
assetIds: [] # CLOB token ids to subscribe at startup
skills: true # register the embedded knowhow skill
- id: polymarket-stream
disabled: false # rows can be toggled individually
Trading setup
- Create L2 API credentials once (any method):
polymarket-client(Python):AsyncSecureClient.create(private_key=pk).credentials, or- install
@polymarket/clientinto the profile and readclient.credentialsaftercreateSecureClient.
- Put the four values in config or
POLY_*environment variables. - For order placement, also make the unified SDK resolvable and set
POLY_PRIVATE_KEY:
dsh plugin --profile my-profile add @polymarket/client viem
Read-only account tools (orders, trades, cancels, balances, heartbeat) work without the SDK — they sign requests with Node's built-in HMAC (L2 headers POLY_ADDRESS/SIGNATURE/TIMESTAMP/API_KEY/PASSPHRASE).
⚠️ Trading is real money. Heartbeats cancel all open orders after a >10s lapse; FOK/FAK BUY
amountis dollars, SELL is shares. Readknowledge/order-patterns.mdfirst.
Using the service from other plugins
export const inject = ['polymarket']
export function apply(ctx) {
const { gamma, clob, dataApi } = ctx.polymarket
const events = await ctx.polymarket.gamma.listEvents({ active: true, limit: 10 })
const book = await clob.getBook(tokenId)
ctx.on('polymarket/market-event', (event) => { /* stream.enabled */ })
}
Knowledge modules (bundled)
SKILL.md (entry) · api-endpoints (full verified inventory) · authentication · order-patterns · market-data · websocket · concepts · ctf-operations · fees · bridge · gasless · error-codes · rate-limits · geoblock · perps · combos-rfq
Load via the skill tool (name: polymarket) or directly with polymarket_knowledge (topic or free-text search).
Verification methodology
- Every REST surface was cross-checked against the official OpenAPI specs fetched from docs.polymarket.com.
- Endpoints were then exercised live (read paths) — which caught real drift: camelCase sort fields (
volume_24hr→ 422), flat batch payloads (paramswrapper returns[]),/live-volume?id=(not?event=), geoblock living onpolymarket.com/api/geoblock, and moved exchange contract addresses. tests/unit(28 tests): hardcoded HMAC golden vectors, retry/Retry-After/error mapping over a local server, tool execution over stubbed fetch incl. cancel happy paths and failure propagation.tests/live(11 tests): production smoke tests against Gamma/CLOB/Data-API/Perps.
npm test # unit suite (builds first)
npm run test:live # hits the real APIs, read-only
Repository layout
├── cordis.patch.yml # bundle patch: 4 plugin rows
├── src/
│ ├── http.ts # fetch + retry + geoblock error mapping
│ ├── config.ts # Schemastery schema + credential resolution
│ ├── gamma.ts # Gamma client ├── data.ts # Data API client
│ ├── clob.ts # CLOB client + L2 HMAC signing
│ ├── perps.ts # Perps client ├── extras.ts # Bridge/RFQ/Relayer/geoblock
│ ├── signing.ts # optional official-SDK order signing
│ ├── service.ts # PolymarketService (ctx.polymarket)
│ ├── tools.ts # all model tools
│ ├── skills.ts # runtime skill registration
│ └── stream.ts # WebSocket bridge
├── knowledge/ # 16 markdown modules (the "knowhow")
└── tests/{unit,live}/
See CLAUDE.md for agent-oriented development guidance.
Credits & license
MIT — see LICENSE and THIRD_PARTY_NOTICES.md.
Knowledge modules adapted from atompilot/polymarket-skill (MIT © atompilot), extended and corrected against current official documentation.
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37918
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37097
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 8650
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5964
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2216
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
helloHub1212/dsh-windows-mcp★ 2002
Bridges the CursorTouch/Windows-MCP desktop automation server into DSH through the official MCP client bridge, registering its screenshot, UI tree snapshot, mouse and keyboard input, clipboard, process and registry tools as mcp__windows__* tools for the model, and adds a windows_mcp_doctor diagnostic tool. Computer Use is off by default and is switched on from the plugin panel.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.