---
name: thirdfy-polymarket
description: "Use Polymarket through Thirdfy (28 reads, 9 writes): one MCP, CLI and API for every agent, with each write checked against the owner's policy before it signs."
---

# Polymarket through Thirdfy

Browse prediction markets, place and cancel orders, and redeem on Polymarket.

- Status: Live
- Chains: Polygon
- Can touch: 9 write actions from the agent's wallet, each checked against the owner's mandate before it signs.
- Directory: https://v2.thirdfy.com/protocols/polymarket

## Connect

- MCP: `claude mcp add --transport http thirdfy https://mcp.thirdfy.com/mcp` (docs: https://docs.thirdfy.com/documentation/mcp)
- CLI: `npx @thirdfy/agent-cli@latest login` (add `--trade` to allow writes), then `npx @thirdfy/agent-cli@latest whoami`
- The owner allows Polymarket for the agent: https://v2.thirdfy.com/integrations/polymarket

## Actions

- `cancel-polymarket-order` (write): Cancels one authenticated Polymarket CLOB order by order ID/order hash.
- `cancel-prediction-order` (write): Generic prediction order cancellation.
- `complete-polymarket-onboarding` (write): Runtime-owned Polymarket setup: prepares the trading wallet (approvals and credentials), then reports whether Base USDC funding is still required.
- `execute-polymarket-bridge-deposit` (write): Sends Base USDC from the managed execution wallet to the official Polymarket Bridge EVM deposit address.
- `execute-polymarket-bridge-withdraw` (write): Sends deposit-wallet pUSD to the official Polymarket Bridge withdraw EVM address via relayer batch.
- `place-polymarket-order` (write): Places a Polymarket limit order using the server CLOB wallet (tokenID, price, size, side).
- `place-prediction-order` (write): Generic prediction order placement.
- `redeem-polymarket-positions` (write): Redeems resolved Polymarket CTF positions on the deposit wallet only.
- `withdraw-polymarket-collateral` (write): Recovers Polymarket collateral from the deposit wallet: clear orders, redeem resolved positions, then unwrap pUSD via CollateralOfframp on Polygon.
- `create-polymarket-bridge-deposit` (read): Creates Polymarket official Bridge deposit addresses for the agent deposit wallet (Base USDC → pUSD).
- `create-polymarket-bridge-withdraw` (read): Creates one-shot Polymarket official Bridge withdraw addresses (deposit pUSD → destination token on execution wallet).
- `get-polymarket-balance-allowance` (read): Reads Polymarket CLOB collateral or conditional-token balance/allowance.
- `get-polymarket-bridge-status` (read): Polls Polymarket official Bridge status for a bridge EVM address.
- `get-polymarket-bridge-supported-assets` (read): Lists chains and tokens supported by Polymarket official Bridge.
- `get-polymarket-event` (read): Fetches a single Polymarket Gamma event by slug, preferring the path-style detail endpoint before query lookup.
- `get-polymarket-events` (read): Lists Polymarket Gamma events with docs-backed active/closed, tag, slug, liquidity, volume, date, and pagination filters.
- `get-polymarket-funding-status` (read): Reads Polymarket trading-wallet funding status: Base USDC balance, trading collateral, recommended funding path, and next action.
- `get-polymarket-market` (read): Fetches a single Polymarket Gamma market by slug, preferring the path-style detail endpoint and returning outcomes and token IDs.
- `get-polymarket-markets` (read): Lists Polymarket Gamma markets with docs-backed slug, token, condition, tag, liquidity, volume, date, sort, and pagination filters.
- `get-polymarket-onboarding-plan` (read): Plans Polymarket trading-wallet onboarding from Base USDC through setup and order readiness.
- `get-polymarket-order` (read): Get a single Polymarket order by its ID (order hash) for the authenticated user.
- `get-polymarket-order-book` (read): Fetches Polymarket CLOB order book depth for an outcome token.
- `get-polymarket-price-history` (read): Fetches Polymarket CLOB historical prices for a market/token with optional interval/time bounds.
- `get-polymarket-prices` (read): Fetches Polymarket CLOB midpoint, side-specific market price, spread, and last-trade price for one or more outcome tokens.
- `get-polymarket-recovery-status` (read): Reads Polymarket recovery status: deposit pUSD, Base USDC, open orders, redeemable positions, and whether managed withdraw is available.
- `get-polymarket-setup-status` (read): Checks Polymarket trading-wallet readiness for the connected agent wallet: setup, funding, collateral balance, and trading eligibility.
- `get-polymarket-tags` (read): Lists Polymarket Gamma tags so agents can discover category/tag IDs and slugs before fetching events or markets.
- `get-polymarket-user-orders` (read): Fetches authenticated Polymarket CLOB user orders/open orders, optionally filtered by order ID, market, or outcome token.
- `get-polymarket-user-positions` (read): Lists Polymarket Data API open positions for the agent deposit wallet (outcome holdings).
- `get-prediction-events` (read): Generic prediction event discovery.
- `get-prediction-market` (read): Generic prediction-market detail read.
- `get-prediction-markets` (read): Generic prediction-market discovery.
- `get-prediction-order-book` (read): Generic prediction-market order book read.
- `get-prediction-tags` (read): Generic prediction category/tag discovery.
- `prepare-polymarket-onboarding` (read): Dry-runs the guided Polymarket trading-wallet setup sequence.
- `search-polymarket` (read): Searches Polymarket Gamma public search across markets, events, tags, and profiles with docs-backed query/tag/status filters.
- `search-prediction-markets` (read): Generic prediction search.

## Rules

- Call these actions through Thirdfy, not with your own keys: Thirdfy builds each transaction and the owner's policy checks it before it signs.
- A write that the owner has not allowed, or that breaks a limit, is refused before signing and costs nothing.