A comprehensive Model Context Protocol (MCP) server for interacting with Polymarket, the world's largest prediction market platform. This server provides seamless access to Polymarket's APIs, enabling AI assistants to retrieve market data, user positions, trading history, and more.
A comprehensive Model Context Protocol (MCP) server for interacting with Polymarket, the world's largest prediction market platform. This server provides seamless access to Polymarket's APIs, enabling AI assistants to retrieve market data, user positions, trading history, and more.
스타
12
도구
—
가동 시간
—
🚀 Features
Market Data
Get Markets: Retrieve prediction markets with filtering and pagination
Get Events: Access event data containing multiple related markets
Market Prices: Real-time and historical price data with technical analysis
Order Book: Live bid/ask data with market depth analysis
Trading & Activity
Trade History: Comprehensive trading data with statistics
User Positions: Portfolio tracking with P&L calculations
User Activity: On-chain activity including trades, splits, merges, and rewards
Market Holders: Ownership distribution and concentration analysis
Advanced Analytics
Liquidity analysis and market depth
Price trend analysis and volatility metrics
Portfolio performance tracking
Market concentration and distribution insights
📦 Installation
Prerequisites
Node.js 18+
TypeScript 5.3+
npm or yarn
Setup
Clone the repository
git clone <repository-url>
cd polymarket-mcp
Install dependencies
npm install
Build the project
npm run build
Start the server
npm start
🔧 Configuration
Claude Desktop Integration
Method 1: Stdio Mode (Recommended for Development)
get_markets({
limit?: number, // Max results (default: 20, max: 100)
offset?: number, // Pagination offset
active?: boolean, // Filter by active status
search?: string, // Search by title/description
order?: string, // Sort by: volume, liquidity, start_date, end_date
liquidity_min?: number, // Minimum liquidity threshold
volume_min?: number // Minimum volume threshold
})
2. Get Events
get_events({
limit?: number, // Max results (default: 20, max: 100)
offset?: number, // Pagination offset
active?: boolean, // Filter by active status
search?: string, // Search by title/description
order?: string // Sort by: volume, liquidity, start_date, end_date
})
3. Get User Positions
get_user_positions({
user_address: string, // Required: User's wallet address
limit?: number, // Max results (default: 50, max: 100)
market_id?: string, // Filter by specific market
min_size?: number, // Minimum position size
show_zero_positions?: boolean // Include zero positions
})
4. Get User Activity
get_user_activity({
user_address: string, // Required: User's wallet address
limit?: number, // Max results (default: 50, max: 100)
activity_type?: string, // TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION
side?: string, // BUY or SELL (for trades)
start_date?: string, // ISO 8601 date format
end_date?: string // ISO 8601 date format
})
5. Get Market Prices
get_market_prices({
market_id?: string, // Market ID (required if no token_id)
token_id?: string, // Token ID (required if no market_id)
interval?: string, // 1m, 5m, 1h, 1d (default: 1h)
fidelity?: number, // Number of price points (default: 100, max: 1000)
include_orderbook?: boolean // Include current order book
})
6. Get Trades
get_trades({
limit?: number, // Max results (default: 50, max: 100)
market_id?: string, // Filter by market
user_address?: string, // Filter by user
side?: string, // BUY or SELL
min_size?: number, // Minimum trade size
start_date?: string, // ISO 8601 date format
end_date?: string // ISO 8601 date format
})
7. Get Order Book
get_order_book({
market_id?: string, // Market ID (required if no token_id)
token_id?: string, // Token ID (required if no market_id)
depth?: number, // Price levels to show (default: 10, max: 50)
include_spread_analysis?: boolean, // Include spread analysis
include_liquidity_analysis?: boolean // Include liquidity analysis
})
8. Get Market Holders
get_market_holders({
market_id?: string, // Market ID (required if no token_id)
token_id?: string, // Token ID (required if no market_id)
limit?: number, // Max results (default: 50, max: 100)
min_balance?: number, // Minimum balance threshold
include_user_info?: boolean // Include user profiles
})
📊 Example Usage
Get Active Markets
Show me the top 10 most liquid active prediction markets
Analyze User Portfolio
Get positions for wallet address 0x1234... and show P&L analysis
Market Analysis
Get order book for market ID abc123 with liquidity analysis
Trading History
Show recent trades for market xyz789 with volume over 1000 shares
🏗️ Architecture
src/
├── index.ts # MCP server entry point
├── lib/
│ └── polymarketClient.ts # Polymarket API client
└── tools/ # Business logic tools
├── getMarkets.ts
├── getEvents.ts
├── getUserPositions.ts
├── getUserActivity.ts
├── getMarketPrices.ts
├── getTrades.ts
├── getOrderBook.ts
└── getMarketHolders.ts
🔗 API Coverage
This MCP server integrates with multiple Polymarket APIs:
Gamma Markets API: Market data and metadata
CLOB API: Order book and trading data
Data API: User positions, activity, and analytics
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📄 License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
The open-source community for inspiration and tools
Built with ❤️ for the prediction markets ecosystem
P
PolyMarket
guangxiangdebizi·스타 12개·
A comprehensive Model Context Protocol (MCP) server for interacting with Polymarket, the world's largest prediction market platform. This server provides seamless access to Polymarket's APIs, enabling
A comprehensive Model Context Protocol (MCP) server for interacting with Polymarket, the world's largest prediction market platform. This server provides seamless access to Polymarket's APIs, enabling AI assistants to retrieve market data, user positions, trading history, and more.
도구
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
질문
PolyMarket은(는) 어떻게 설치하나요?
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
마지막 확인: 2026-10-28. A comprehensive Model Context Protocol (MCP) server for interacting with Polymarket, the world's largest prediction market platform. This server provides seamless access to Polymarket's APIs, enabling AI assistants to retrieve market data, user positions, trading history, and more.