Polymarket MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Polymarket MCP Server Show me top Polymarket markets by volume"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Polymarket MCP Server
A Model Context Protocol (MCP) server for seamless Polymarket integration
π Overview
Polymarket MCP Server provides a comprehensive toolkit for accessing Polymarket data through the Model Context Protocol. This server enables seamless integration with Claude and other MCP clients, allowing you to search markets, fetch events, analyze leaderboards, query user activity, and much more.
Related MCP server: Polymarket MCP
β¨ Features
π Market Search & Browsing - List and search Polymarket markets with advanced filtering, pagination, and sorting
π Event Management - Discover and retrieve detailed information about Polymarket events
π·οΈ Tag System - Browse available tags for categorizing and filtering markets and events
π Leaderboard Data - Access trader rankings based on profitability and volume
π€ User Analytics - Get detailed user activity including trades, splits, and merges
πΌ Wallet Analysis - Query trades and holdings for specific wallet addresses
π Market Insights - View top holders, open interest, and live volume data
π Full Search - Comprehensive search across markets, events, and profiles
π οΈ Available Tools
Market Tools
list_markets- List Polymarket markets with optional filtering by tags, pagination, and sortingsearch_polymarket- Search Polymarket markets, events, and profiles using the public search APIget_market_by_slug- Fetch a specific Polymarket market by its slug identifier
Event Tools
list_events- List Polymarket events with optional filtering by tags, pagination, and sortingget_event_by_slug- Fetch a specific Polymarket event by its slug identifierget_live_volume- Get live volume data for a specific Polymarket event
Analytics Tools
get_open_interest- Get open interest data for Polymarket marketsget_top_holders- Get top holders for specified Polymarket marketsget_leaderboard- Fetch Polymarket trader leaderboard rankings (most profitable / highest volume traders)
User & Wallet Tools
get_user_activity- Get user activity from Polymarket including trades, splits, merges, and rewardsget_trades_by_wallet- Get all trades for a Polymarket wallet address using the public Data API
Category Tools
list_tags- List all available Polymarket tags for filtering markets and events
π¦ Installation
Prerequisites
Node.js (v18 or higher)
pnpm (or npm/yarn)
Setup
Clone the repository
git clone https://github.com/yashhsm/polymarket-mcp.git
cd polymarket-mcpInstall dependencies
pnpm installBuild the project
pnpm buildStart the server
pnpm startπ§ Usage
This MCP server can be used with any MCP-compatible client. Configure your client to connect to this server's stdio transport, and you'll have access to all available Polymarket tools.
Example: Using with Claude Desktop
Add this configuration to your Claude Desktop config file (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"polymarket": {
"command": "node",
"args": ["/absolute/path/to/polymarket-mcp/dist/index.js"]
}
}
}Note: Replace /absolute/path/to/polymarket-mcp with the actual absolute path to your cloned repository.
Example Queries
Once configured, you can ask Claude:
"Show me the top 10 trending Polymarket markets"
"What are the current odds for the 2024 election markets?"
"Who are the top traders on Polymarket this month?"
"Search for markets related to cryptocurrency"
"Show me live volume data for a specific event"
ποΈ Development
Building
pnpm buildDevelopment Mode
Run with hot reload:
pnpm devRunning Tests
pnpm testEvaluation Mode
pnpm evalπ Project Structure
src/
βββ index.ts # Main MCP server setup and tool registration
βββ constants.ts # Configuration constants and API endpoints
βββ eval.ts # Evaluation utilities
βββ prompt-evals.ts # Prompt evaluation functions
βββ tools/ # Tool implementations
βββ index.ts # Tool exports
βββ markets.ts # Market-related tools
βββ events.ts # Event-related tools
βββ leaderboard.ts # Leaderboard tools
βββ user.ts # User activity tools
βββ ... # Additional tool implementationsπ API Integration
This server integrates with the following Polymarket public APIs:
Markets API - For market data and search functionality
Events API - For event information and details
User API - For user activity and wallet data
Leaderboard API - For trader rankings and statistics
Data API - For trades, holders, and volume data
π οΈ Technology Stack
Node.js - JavaScript runtime environment
TypeScript - Type-safe JavaScript development
MCP SDK - Model Context Protocol SDK
Zod - Schema validation and type safety
π€ Contributing
Contributions are welcome! If you'd like to contribute:
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π¬ Support
For issues, feature requests, or questions:
Issues: Use the GitHub Issues page
Discussions: Join the GitHub Discussions
π Acknowledgments
Built with the Model Context Protocol
Data provided by Polymarket
Made with β€οΈ by the Polymarket MCP community
Available Tools
15 toolsget_event_by_slugB
Fetch a specific Polymarket event by its slug identifier
Inputs: slug (required).
get_leaderboardB
Fetch Polymarket trader leaderboard rankings (most profitable / highest volume traders)
Inputs: user, limit, offset, orderBy, +3 more.
get_live_volumeB
Get live volume for a specific Polymarket event
Inputs: eventId (required).
get_market_by_slugB
Fetch a specific Polymarket market by its slug identifier
Inputs: slug (required).
get_open_interestC
Get open interest for Polymarket markets
Inputs: market, eventId.
get_top_holdersC
Get top holders for specified Polymarket markets
Inputs: market (required), limit, minBalance.
get_trades_by_walletC
Get all trades for a Polymarket wallet address using the public Data API
Inputs: walletAddress (required), side, limit, market, +3 more.
get_user_activityC
Get user activity from Polymarket including trades, splits, merges, and rewards
Inputs: user (required), limit, types, market, +2 more.
list_eventsC
List Polymarket events with optional filtering by tags, pagination, and sorting
Inputs: limit, order, closed, offset, +4 more.
list_marketsB
List Polymarket markets with optional filtering by tags, pagination, and sorting
Inputs: limit, order, closed, offset, +4 more.
list_tagsA
List all available Polymarket tags for filtering markets and events
Inputs: no named parameters.
search_polymarketC
Search Polymarket markets, events, and profiles using the public search API
Inputs: q (required), page, sort, cache, +10 more.
ws_get_orderbookA
Get live orderbook snapshot for a Polymarket asset via WebSocket. Returns current bids and asks.
Inputs: assetId (required), durationSeconds.
ws_subscribe_pricesB
Subscribe to real-time price updates for Polymarket assets via WebSocket. Collects price changes for specified duration.
Inputs: assetIds (required), durationSeconds.
ws_subscribe_tradesA
Subscribe to real-time trade updates for Polymarket assets via WebSocket. Collects trades for specified duration.
Inputs: assetIds (required), durationSeconds.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 15 tools
Most tools target clearly distinct resources/actions (markets, events, tags, holders, leaderboard, orderbook, trades). A few overlap: search_polymarket can return markets and events that list_markets/list_events also return, and get_user_activity (includes trades) overlaps with get_trades_by_wallet. Descriptions mostly clarify the boundaries, so confusion is limited.
Nearly all tools follow a snake_case verb_noun pattern (list_markets, get_top_holders, get_event_by_slug). The ws_ prefix group is internally consistent but introduces a second convention, and search_polymarket uses a domain noun instead of a specific resource. Minor deviations, still highly predictable.
15 tools sit at the top of the well-scoped range and each maps to a genuine capability (REST listing, slug lookups, search, analytics metrics, WebSocket streams). No redundant or filler tools are apparent for a read-only market-data server.
Coverage is strong for read-only analytics: markets, events, tags, search, holders, leaderboard, user activity, wallet trades, open interest, volume, and real-time streams. Minor gaps exist around historical price/candle data and any trading or comment operations, but core discovery and analytics workflows are covered.
Maintenance
Related MCP Connectors
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
Polyrank MCP server: rank Polymarket traders by forecasting skill (calibration, Brier score, edge vs. market price) and check any wallet's record from Claude, Cursor or any MCP client. 17 tools free with no key. Sign in (OAuth) for the rest; the Ranking Builder, full metrics and the AI Lab (backtest, paper-trade copy strategies) need a paid plan.
Polymarket MCP β prediction-market data via Gamma + CLOB + Data public APIs.
Polymarket in your AI: market rules, real fill costs, who is trading, top traders. Read-only.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables interaction with Polymarket prediction markets through Claude Desktop.31MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for Polymarket prediction markets, providing real-time market data, prices, and AI-powered analysis tools for Claude Desktop integration.48MIT
- AlicenseCqualityDmaintenanceMCP server exposing 47 Polymarket API tools for AI assistants. Covers the full Gamma, CLOB, and Data APIs plus a fluent MarketBuilder for multi-source queries.4715 npm2MIT
- AlicenseBqualityCmaintenanceMCP server for Polymarket prediction markets enabling query of markets, events, narratives, arbitrage, and more via MCP or HTTP.91MIT