How do I use Polyforge MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Polyforge MCP Server list my active strategies" 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.

Polyforge MCP Server

by F4CTE

Overview Schema Related Servers Score Discussions

JavaScript

Remote

Polyforge MCP Server

MCP (Model Context Protocol) server that lets AI assistants interact with the Polyforge prediction market trading platform.

Implements the open MCP 1.0 stdio standard — compatible with Claude Desktop, Claude Code, Cursor, Windsurf, Zed, Continue, and any MCP-compliant host.

Quick Start

npx @polyforge/mcp-server

Setup

1. Get an API Key

Generate an API key in the Polyforge web app: Settings > API Keys > Create Key.

Claude Desktop

Add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "polyforge": {
      "command": "npx",
      "args": ["@polyforge/mcp-server"],
      "env": {
        "POLYFORGE_API_KEY": "pf_live_your_key"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add polyforge -- npx @polyforge/mcp-server
export POLYFORGE_API_KEY=pf_live_your_key

Cursor

Open Cursor Settings → MCP → Add Server, or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "polyforge": {
      "command": "npx",
      "args": ["@polyforge/mcp-server"],
      "env": {
        "POLYFORGE_API_KEY": "pf_live_your_key"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "polyforge": {
      "command": "npx",
      "args": ["@polyforge/mcp-server"],
      "env": {
        "POLYFORGE_API_KEY": "pf_live_your_key"
      }
    }
  }
}

Zed

Add to settings.json under context_servers:

{
  "context_servers": {
    "polyforge": {
      "command": {
        "path": "npx",
        "args": ["@polyforge/mcp-server"],
        "env": {
          "POLYFORGE_API_KEY": "pf_live_your_key"
        }
      }
    }
  }
}

Continue.dev

Add to ~/.continue/config.json under mcpServers:

{
  "mcpServers": [
    {
      "name": "polyforge",
      "command": "npx",
      "args": ["@polyforge/mcp-server"],
      "env": {
        "POLYFORGE_API_KEY": "pf_live_your_key"
      }
    }
  ]
}

Custom / Any MCP Client

Install globally and spawn:

npm install -g @polyforge/mcp-server
POLYFORGE_API_KEY=pf_live_your_key polyforge-mcp

Available Tools (136)

Markets & Price Data (9)

Tool	Description
`list_markets`	Browse prediction markets with search, category filter, pagination
`get_market`	Get market details including tokens, prices, order book depth
`search_markets`	Search prediction markets by keyword
`get_price_history`	Historical price candles (1m/1h/1d) with optional date range
`get_tick_size`	Minimum tick size (price increment) for a token on the CLOB
`get_spread`	Current bid-ask spread for a market token
`get_midpoint`	Current midpoint price for a market token
`get_clob_book`	Full CLOB order book (bids and asks) for a token
`get_clob_prices_history`	Historical CLOB prices with configurable interval and fidelity

Strategies (16)

Tool	Description
`list_strategies`	List your strategies with status filter, sorting, pagination
`get_strategy`	Get full strategy details including blocks, configuration, run history
`create_strategy`	Create a new strategy with blocks, execution mode, visibility, tags
`update_strategy`	Update a strategy's blocks, execution mode, visibility, tags
`create_strategy_from_description`	AI-generate a strategy from natural language
`start_strategy`	Start in live or paper (simulated) mode
`stop_strategy`	Stop a running strategy
`pause_strategy`	Pause a running strategy (keeps state, can resume)
`resume_strategy`	Resume a previously paused strategy
`fork_strategy`	Fork a strategy to create a new editable copy
`delete_strategy`	Permanently delete a stopped strategy
`import_strategy`	Import a strategy from a .polyforge JSON export
`export_strategy`	Export strategy as a portable .polyforge JSON file
`get_strategy_templates`	List available strategy templates
`list_strategy_versions`	List saved version history of a strategy
`rollback_strategy`	Roll back a strategy to a previous version

Strategy Monitoring (2)

Tool	Description
`get_strategy_events`	Poll recent execution events (cursor-based live feed)
`get_strategy_event_log`	Persistent audit log (execution history, parameter changes, starts/stops)

Tool	Description
`like_strategy`	Like a public strategy
`list_strategy_comments`	List comments on a public strategy
`add_strategy_comment`	Post a comment on a public strategy
`delete_strategy_comment`	Delete one of your own comments
`list_strategy_children`	List strategies forked from a given strategy
`report_strategy`	Report a strategy for violating community guidelines

Discovery & Leaderboard (3)

Tool	Description
`get_actions`	Platform action catalog — all API endpoints with method, path, and parameters for runtime discovery
`discover_strategies`	Browse public community strategies with sort and search
`get_leaderboard`	Top trader leaderboard ranked by P&L (7d/30d/allTime)

Marketplace (8)

Tool	Description
`browse_marketplace`	Browse the Strategy Marketplace (sort, tag filter, pagination)
`get_marketplace_listing`	Full listing details including reviews and performance stats
`purchase_strategy`	Purchase a marketplace strategy (creates a private fork)
`create_marketplace_listing`	Publish your strategy to the marketplace
`update_marketplace_listing`	Update title, priceUsdc, description, tags, or status of your listing
`rate_marketplace_listing`	Rate and review a purchased strategy (1–5 stars)
`get_my_listings`	List your published marketplace strategies with sales count
`get_my_purchases`	List marketplace strategies you have purchased

Orders & Execution (13)

Tool	Description
`place_order`	Place a buy/sell order (GTC/FOK/GTD/FAK/POST_ONLY)
`cancel_order`	Cancel a pending or live order
`get_orders`	List recent orders with status, strategy, market, date filters
`place_smart_order`	Advanced execution: TWAP, DCA, BRACKET, or OCO
`list_smart_orders`	List smart orders with execution progress
`cancel_smart_order`	Cancel a smart order and all child orders
`place_batch_orders`	Place 1–15 orders in a single batch
`cancel_orders_bulk`	Cancel 1–3000 orders in bulk
`list_conditional_orders`	List take-profit, stop-loss, trailing stop orders
`create_conditional_order`	Create a conditional order (TP/SL/trailing/limit/pegged)
`get_conditional_order`	Get details of a specific conditional order
`cancel_conditional_order`	Cancel a pending conditional order
`get_arbitrage_opportunities`	Scan markets for merge arbitrage (YES+NO < $1.00)

Portfolio & Positions (10)

Tool	Description
`get_portfolio`	Current positions, unrealized P&L, account summary
`get_portfolio_pnl`	P&L chart data and win-rate for a time period
`get_portfolio_review`	AI-generated portfolio review and optimization suggestions
`close_position`	Close an open position at market price
`split_position`	Split USDC.e collateral into YES and NO tokens
`merge_position`	Merge YES and NO tokens back into USDC.e
`redeem_position`	Redeem winning shares after market resolution
`get_polymarket_portfolio`	Polymarket-native portfolio (positions, balances, exposure)
`get_polymarket_earnings`	Polymarket-native earnings (realized PnL, redeemed winnings)
`get_polymarket_activity`	Polymarket-native activity feed (trades, redemptions)

Copy Trading (8)

Tool	Description
`list_copy_configs`	List your copy trading configurations
`create_copy_config`	Create a new config to mirror trades from a target wallet
`get_copy_config`	Get details of a specific copy config
`update_copy_config`	Update sizing mode, risk limits, or price offset
`pause_copy_config`	Pause — no new trades copied until resumed
`resume_copy_config`	Resume a paused copy config
`delete_copy_config`	Permanently delete a copy config
`get_copy_trades`	List all trades executed under a copy config

Whale Intelligence (6)

Tool	Description
`get_whale_feed`	Recent large trades (whale activity)
`get_top_whales`	Top whales ranked by volume, P&L, win rate, or trade count
`get_whale_profile`	Full trading profile for a specific whale wallet
`follow_whale`	Follow a whale to receive their trades in your feed
`unfollow_whale`	Unfollow a whale wallet
`get_followed_whales`	List all whale wallets you are following

News & Signals (4)

Tool	Description
`get_news_signals`	AI-generated trading signals derived from news
`get_market_sentiment`	Aggregated news sentiment (BULLISH/BEARISH/NEUTRAL)
`list_news`	List recent news articles relevant to prediction markets
`get_news_article`	Get full content of a specific news article

Scoring & Badges (7)

Tool	Description
`get_score`	Your trader edge score, rank, and badges
`get_accuracy`	Prediction accuracy (Brier score, calibration, win rate)
`get_accuracy_leaderboard`	Accuracy leaderboard ranked by win-rate
`get_top_scores`	Top user scores leaderboard
`get_my_badges`	Badges earned by you
`get_user_score`	Score and trading stats for a specific user
`get_user_badges`	Badges earned by a specific user

Backtesting (4)

Tool	Description
`list_backtests`	List historical backtests with status filter
`get_backtest`	Full results and candle data for a specific backtest
`run_backtest`	Start a new backtest over a historical date range
`get_backtest_orders`	Simulated order log from a completed backtest

Alerts (3)

Tool	Description
`list_alerts`	List your configured price alerts
`create_alert`	Create a price alert (triggers when price crosses threshold)
`delete_alert`	Delete an existing price alert

Watchlist (4)

Tool	Description
`list_watchlist`	List watched markets with prices, volume, and price delta
`add_to_watchlist`	Add a market to your watchlist
`remove_from_watchlist`	Remove a market from your watchlist
`get_watchlist_status`	Check if a specific market is on your watchlist

Webhooks (4)

Tool	Description
`list_webhooks`	List your registered webhook endpoints
`create_webhook`	Register a webhook for real-time event notifications
`delete_webhook`	Delete a registered webhook
`test_webhook`	Send a test event payload to verify delivery

Rewards & Rebates (10)

Tool	Description
`list_rewards_markets`	List markets eligible for liquidity rewards
`get_rewards_for_market`	Reward details for a specific market
`get_market_rewards`	Liquidity reward data for a market (reward rate, total, remaining, max spread, min size)
`get_sponsor_url`	Polymarket deep-link URL for sponsoring a market's liquidity rewards
`get_sponsored_markets`	Markets you have sponsored for liquidity rewards
`get_user_rewards`	Your accrued liquidity rewards
`get_user_rewards_total`	Total accumulated rewards with date breakdown
`get_user_rewards_percentages`	Reward allocation percentages across markets
`get_user_rewards_per_market`	Rewards broken down by individual market
`get_user_rebates`	Your trading rebates

Paper Trading (2)

Tool	Description
`get_paper_summary`	Paper trading account summary (virtual balance, P&L, positions)
`reset_paper_account`	Reset paper account to initial virtual balance

Risk Management (3)

Tool	Description
`get_risk_settings`	Current drawdown circuit-breaker settings
`update_risk_settings`	Update drawdown threshold, lookback window, enable/disable
`reset_circuit_breaker`	Reset tripped circuit breaker to allow new orders

API Keys (3)

Tool	Description
`list_api_keys`	List all API keys associated with your account
`create_api_key`	Create a new API key with scoped permissions
`revoke_api_key`	Permanently revoke an API key

Liquidity (1)

Tool	Description
`provide_liquidity`	Provide liquidity by depositing USDC.e on a market token

AI (1)

Tool	Description
`ai_query`	Natural language questions about your account, strategies, or markets

Batch (1)

Tool	Description
`batch_requests`	Execute multiple API requests in a single call (max 10)

Sports Markets (9)

Tool	Description
`list_sports_categories`	List sports categories with series tickers and live counts
`list_sports_markets`	Browse sports prediction markets with category, series, event, live-only, and sort filters
`list_sports_events`	List sports events filtered by category, series, or status (`SCHEDULED`/`PREGAME`/`LIVE`/`HALFTIME`/`FINAL`)
`get_sports_event`	Get a single sports event with its associated markets
`list_sports_milestones`	List in-game milestones with optional event-ticker and status filters
`get_sports_live_data`	Get live data payload (score, clock, situational data) for a milestone
`list_sports_combos`	List combo (parlay) collections with optional series-ticker filter
`get_sports_combo_collection`	Fetch a combo collection by ticker (server currently ignores ticker — wrapped as-is)
`lookup_sports_combo`	Look up the combo market matching a set of selected outcomes within a collection

Strategy Execution Watching

get_strategy_events lets Claude poll execution events from a running strategy. MCP tools are request-response only, so this uses a cursor-based approach:

# First call — get the latest events
get_strategy_events(id="strat-uuid", after_timestamp=0, limit=20)
→ { events: [...], nextAfterTimestamp: 1711720500000 }

# Follow-up call — only events newer than the cursor
get_strategy_events(id="strat-uuid", after_timestamp=1711720500000, limit=20)
→ { events: [...], nextAfterTimestamp: 1711720510000 }

For continuous streaming, use the TypeScript, Python, or Rust SDK's watchStrategy/watch_strategy method instead.

Environment Variables

Variable	Required	Default	Description
`POLYFORGE_API_URL`	No	`https://api.polyforge.app`	Polyforge API base URL
`POLYFORGE_API_KEY`	Yes	—	API key from Settings > API Keys

Example Usage

Once configured, you can ask Claude:

"Show me the top prediction markets about crypto"
"Create a strategy that buys YES on markets where the price drops below 30 cents"
"What's my portfolio P&L this week?"
"Start my momentum strategy in paper mode"
"Show me whale trades over $50,000"
"What events have fired on my running strategy in the last minute?"
"Buy 10 YES shares on this market at 0.65"
"Set up a DCA smart order to buy $500 over 5 slices every hour"
"Show me arbitrage opportunities with at least 2% margin"
"Copy trades from this whale wallet with a $100 fixed amount per trade"
"Run a backtest on my momentum strategy from Jan to March"
"What are my liquidity rewards this month?"
"Show the full order book for this token"

Development

git clone https://github.com/F4CTE/polyforge-mcp.git
cd polyforge-mcp
pnpm install
pnpm build

Test locally:

POLYFORGE_API_KEY=pf_test_key pnpm start

License

Apache 2.0 — see LICENSE for details.

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

22hResponse time

–Release cycle

–Releases (12mo)

Issues opened vs closed

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/F4CTE/polyforge-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Polyforge MCP Server

Quick Start

Setup

1. Get an API Key

Claude Desktop

Claude Code (CLI)

Cursor

Windsurf

Zed

Continue.dev

Custom / Any MCP Client

Available Tools (136)

Markets & Price Data (9)

Strategies (16)

Strategy Monitoring (2)

Strategy Social (6)

Discovery & Leaderboard (3)

Marketplace (8)

Orders & Execution (13)

Portfolio & Positions (10)

Copy Trading (8)

Whale Intelligence (6)

News & Signals (4)

Scoring & Badges (7)

Backtesting (4)

Alerts (3)

Watchlist (4)

Webhooks (4)

Rewards & Rebates (10)

Paper Trading (2)

Risk Management (3)

API Keys (3)

Liquidity (1)

AI (1)

Batch (1)

Sports Markets (9)

Strategy Execution Watching

Environment Variables

Example Usage

Development

License

Maintenance

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API