← Back to Skills Marketplace
aisofialuz

Polymarket MCP — Live Markets & Prices

by AIsofialuz · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
65
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install polymarket-live-markets
Description
Real-time access to Polymarket prediction markets via the official Gamma API and CLOB v2 order book. Search thousands of markets on politics, crypto, sports,...
README (SKILL.md)

Polymarket MCP — Live Markets & Prices

Access the world's largest prediction market platform directly from your AI assistant.

What is Polymarket?

Polymarket is a decentralized prediction market platform where people trade on the outcomes of real-world events. Market prices represent the crowd's probability estimate for each outcome — making them some of the most accurate real-time forecasts available.

Why this MCP server?

Most tools that access Polymarket use cached API data with stale prices. polymarket-mcp pulls live prices directly from the CLOB v2 order book — the same data traders use — so you always get the most accurate numbers.

APIs used

API URL Purpose
Gamma API https://gamma-api.polymarket.com Market catalogue, search, metadata
CLOB v2 https://clob.polymarket.com Live order-book midpoint prices, price history

Smart slug resolution

When you search for markets, you get back event slugs. These same slugs work directly with get_market_details and get_current_prices — the server automatically resolves event slugs → most active embedded market, so you never need to manually look up a separate ID.

search_markets("bitcoin")
  → slug: "when-will-bitcoin-hit-150k"

get_current_prices("when-will-bitcoin-hit-150k")   ← works directly
get_market_details("when-will-bitcoin-hit-150k")   ← works directly
get_price_history("when-will-bitcoin-hit-150k", "7d")  ← works directly

Price history sparklines

get_price_history("will-bitcoin-hit-150k-by-june-30-2026", "24h")

  YES outcome  (25 data points)
  Open:   1.5%   Close: 1.1%
  Change: ▼ -0.40pp  (-26.7%)
  High:   1.5%   Low:   0.9%

  Chart: █▅▄█▇▇█▃▃▃▁▁▂▃▃▃▃▃▃▂▄▄▄▄▄
         0.9%                        1.5%
Usage Guidance
Before installing, be comfortable with npm-based setup and with sending Polymarket-related search terms to Polymarket's public APIs. The reviewed artifacts do not show wallet access, trading actions, credential use, persistence, or local data collection.
Capability Analysis
Type: OpenClaw Skill Name: polymarket-live-markets Version: 1.1.0 The polymarket-live-markets skill bundle is a legitimate, read-only MCP server designed to fetch prediction market data from Polymarket's official Gamma and CLOB v2 APIs. Analysis of the source code (server.ts, server.js, and server.py) confirms that it only performs standard HTTP GET requests to authorized endpoints (gamma-api.polymarket.com and clob.polymarket.com) and contains no evidence of data exfiltration, malicious execution, or prompt injection. The included test scripts (test.mjs and test-direct.mjs) are standard for local development and do not pose a security risk.
Capability Tags
cryptorequires-walletrequires-sensitive-credentials
Capability Assessment
✓ Purpose & Capability
The stated purpose, documented tools, and visible code align around read-only market search, pricing, history, and statistics from Polymarket APIs; no trading, wallet use, or credential handling is shown.
ℹ Instruction Scope
The skill exposes tools the agent can call to query public market data. This is coherent with the purpose, but user search terms and market identifiers may be sent to Polymarket APIs.
ℹ Install Mechanism
Registry install metadata says no install spec, while SKILL.md and README describe npm-based setup for a Node MCP server. This is purpose-aligned, but users should intentionally run install/build steps and trust the npm dependency chain.
ℹ Credentials
Network access to Polymarket Gamma and CLOB APIs is expected for live prices. The provided capability signals mention wallet/sensitive credentials, but the reviewed artifacts claim no auth/no wallet and the visible code uses public GET requests.
✓ Persistence & Privilege
No persistent storage, background worker, privilege escalation, local file indexing, account mutation, or destructive behavior is evident in the provided artifacts.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install polymarket-live-markets
  3. After installation, invoke the skill by name or use /polymarket-live-markets
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
v1.1.0: Added search_by_category (browse by politics/crypto/sports/ai) and get_price_history (OHLC stats + Unicode sparkline charts for 1h/6h/24h/7d/30d). Improved search_markets with multi-field relevance scoring across titles, questions, and tags. get_current_prices now shows 24h price change indicator. All output reformatted with compact numbers and section headers. 3-step slug resolver handles market slugs, event slugs, and 0x condition IDs interchangeably. Zero credentials required.
Metadata
Slug polymarket-live-markets
Version 1.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Polymarket MCP — Live Markets & Prices?

Real-time access to Polymarket prediction markets via the official Gamma API and CLOB v2 order book. Search thousands of markets on politics, crypto, sports,... It is an AI Agent Skill for Claude Code / OpenClaw, with 65 downloads so far.

How do I install Polymarket MCP — Live Markets & Prices?

Run "/install polymarket-live-markets" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Polymarket MCP — Live Markets & Prices free?

Yes, Polymarket MCP — Live Markets & Prices is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Polymarket MCP — Live Markets & Prices support?

Polymarket MCP — Live Markets & Prices is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Polymarket MCP — Live Markets & Prices?

It is built and maintained by AIsofialuz (@aisofialuz); the current version is v1.1.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments