# io.github.evidai/polymarket-guard (npm · polymarket-guard-mcp)

Polymarket prediction markets — buy/sell positions in USDC. LemonCake pay-per-call billing.

- Trust score: 69/100 (medium)
- Change this week: +23
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `polymarket-guard-mcp`: 69/100 (this document), [markdown](https://verifymcp.io/servers/evidai-polymarket-guard/polymarket-guard-mcp.md), [page](https://verifymcp.io/servers/evidai-polymarket-guard/polymarket-guard-mcp)

## Channel facts

- Registry: `npm`
- Package: `polymarket-guard-mcp`
- Version: `0.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 72 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 75/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1091 tokens (~99/item across 11 items; 11 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 98/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 95% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add evidai-polymarket-guard -- npx -y polymarket-guard-mcp
```

### Codex

```bash
codex mcp add evidai-polymarket-guard -- npx -y polymarket-guard-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "evidai-polymarket-guard": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "polymarket-guard-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add evidai-polymarket-guard --command npx --arg -y --arg polymarket-guard-mcp
```

### Hermes

```yaml
mcp_servers:
  evidai-polymarket-guard:
    command: "npx"
    args: ["-y", "polymarket-guard-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "evidai-polymarket-guard": {
      "command": "npx",
      "args": [
        "-y",
        "polymarket-guard-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 69, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-08-02 (score 65, +60)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional improvement] Tool coverage: unverified → 100
- [functional] Licence: MIT

### 2026-08-01 (score 5, −16)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-31 (score 21, −25)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (11)

### `list_markets` (~96 tokens)

List active Polymarket prediction markets. Returns market titles, condition IDs, token IDs, volume, and YES/NO prices. Free — no billing.

Input parameters:

- `limit` (number): Max markets to return (default 20, max 100)
- `offset` (number): Pagination offset (default 0)
- `tag` (string): Filter by tag/category, e.g. 'politics', 'crypto', 'sports'

### `search_markets` (~66 tokens)

Search Polymarket markets by keyword. Searches market titles and descriptions. Free — no billing.

Input parameters:

- `limit` (number): Max results (default 20, max 100)
- `query` (string, required): Search keyword(s), e.g. 'bitcoin ETF', 'US election'

### `get_market` (~60 tokens)

Get full details for a single Polymarket market by its condition ID or slug. Includes resolution criteria, outcomes, current prices, and volume. Free — no billing.

Input parameters:

- `condition_id` (string, required): Market condition ID (hex string) or market slug

### `get_order_book` (~67 tokens)

Get the live order book (bids and asks) for a Polymarket market token. Use token_id from list_markets or get_market. Free — no billing.

Input parameters:

- `token_id` (string, required): The token ID for a specific outcome (YES or NO) from get_market

### `get_positions` (~78 tokens)

Get your current open positions on Polymarket: market titles, outcome tokens, shares held, cost basis, and current P&L. Requires POLYMARKET_PRIVATE_KEY. Billed at $0.05 USDC via LemonCake.

Input parameters:

- `size_threshold` (number): Only return positions larger than this (default 0 = all positions)

### `get_balance` (~45 tokens)

Get your USDC balance and token allowances on Polymarket's Polygon contracts. Requires POLYMARKET_PRIVATE_KEY. Billed at $0.05 USDC via LemonCake.

### `get_trade_history` (~81 tokens)

Get your past trades on Polymarket: order IDs, market, outcome, price, size, timestamp. Requires POLYMARKET_PRIVATE_KEY. Billed at $0.05 USDC via LemonCake.

Input parameters:

- `limit` (number): Number of trades to return (default 20, max 100)
- `offset` (number): Pagination offset

### `place_market_order` (~139 tokens)

Buy or sell outcome shares at market price on Polymarket. USDC cost is calculated at the current best ask/bid. Requires POLYMARKET_PRIVATE_KEY. Billed at $0.10 USDC via LemonCake.

Input parameters:

- `amount` (number, required): USDC amount to spend (BUY) or number of shares to sell (SELL)
- `side` (string, required): BUY outcome shares or SELL shares you hold
- `slippage_tolerance` (number): Max acceptable slippage as a decimal (default 0.02 = 2%)
- `token_id` (string, required): Outcome token ID from get_market (YES or NO token)

### `place_limit_order` (~162 tokens)

Place a limit order to buy or sell outcome shares at a specific price on Polymarket CLOB. Requires POLYMARKET_PRIVATE_KEY. Billed at $0.10 USDC via LemonCake.

Input parameters:

- `expiration` (string): Order time-in-force: GTC=Good Till Cancel (default), GTD=till date, FOK=Fill or Kill, IOC=Immediate or Cancel
- `price` (number, required): Limit price (0–1, representing probability/cents per share). E.g. 0.65 = 65 cents.
- `side` (string, required)
- `size` (number, required): Number of shares to buy or sell
- `token_id` (string, required): Outcome token ID (YES or NO) from get_market

### `cancel_order` (~58 tokens)

Cancel an open limit order by order ID. Requires POLYMARKET_PRIVATE_KEY. Billed at $0.10 USDC via LemonCake.

Input parameters:

- `order_id` (string, required): The order ID returned by place_limit_order or get_trade_history

### `redeem_positions` (~71 tokens)

Claim winnings from resolved Polymarket markets. Redeems outcome token shares for USDC if the market resolved in your favor. Requires POLYMARKET_PRIVATE_KEY. Billed at $0.10 USDC via LemonCake.

Input parameters:

- `condition_id` (string, required): Condition ID of the resolved market to redeem from

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/evidai-polymarket-guard/polymarket-guard-mcp#diagnostics

## Score history

- 2026-08-03: 69
- 2026-08-02: 65
- 2026-08-01: 5
- 2026-07-31: 21
- 2026-07-30: 46
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/polymarket-guard-mcp
- Socket report: https://socket.dev/npm/package/polymarket-guard-mcp
- Repository: https://github.com/evidai/agent-payment-mcp
- Changelog RSS feed: https://verifymcp.io/servers/evidai-polymarket-guard/polymarket-guard-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/evidai-polymarket-guard/polymarket-guard-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/evidai-polymarket-guard/polymarket-guard-mcp