{"name":"io.github.demwick/polymarket-agent-mcp","slug":"demwick-polymarket-agent-mcp","title":null,"description":"Polymarket trading, market discovery, copy trading and backtesting — 48 MCP tools.","url":"https://mcp.market/server/demwick-polymarket-agent-mcp","rating":null,"grade":"B","score":83,"certified":false,"status":"active","category":"ai","tags":["ai"],"presence":{"score":39,"stars":16,"forks":6,"downloads_week":66,"last_push_at":"2026-09-24T01:34:19.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/demwick/polymarket-agent-mcp","website":"https://github.com/demwick/polymarket-agent-mcp#readme","version":"1.7.0","remotes":[],"packages":[{"registryType":"npm","identifier":"polymarket-agent-mcp","version":"1.7.0","transport":{"type":"stdio"},"environmentVariables":[{"description":"Execution mode: 'preview' simulates trades in a local SQLite DB (default, safe for inspection); 'live' places real orders on Polymarket and requires all POLY_* credentials.","format":"string","default":"preview","choices":["preview","live"],"name":"COPY_MODE"},{"description":"Polygon wallet private key used to sign CLOB orders. Required only when COPY_MODE=live. Never logged, persisted, or transmitted outside signed order bodies.","format":"string","isSecret":true,"name":"POLY_PRIVATE_KEY"},{"description":"Polymarket CLOB API key. Required only when COPY_MODE=live.","format":"string","isSecret":true,"name":"POLY_API_KEY"},{"description":"Polymarket CLOB API secret. Required only when COPY_MODE=live.","format":"string","isSecret":true,"name":"POLY_API_SECRET"},{"description":"Polymarket CLOB API passphrase. Required only when COPY_MODE=live.","format":"string","isSecret":true,"name":"POLY_API_PASSPHRASE"},{"description":"Polymarket funder wallet address (proxy wallet) used for live trading.","format":"string","name":"POLY_FUNDER_ADDRESS"},{"description":"Maximum USDC the agent may spend per day. Used by BudgetManager to cap copy-trading exposure.","format":"number","default":"20","name":"DAILY_BUDGET"},{"description":"Minimum conviction score (0–100) required before a copy trade is executed.","format":"number","default":"3","name":"MIN_CONVICTION"},{"description":"EVM chain ID for Polymarket (137 = Polygon mainnet).","format":"number","default":"137","name":"CHAIN_ID"},{"description":"Optional override for the SQLite database path. Defaults to a package-local file.","format":"filepath","name":"DB_PATH"}]}],"tools":[{"name":"agent.log_cycle","description":"Record an AI agent's trading cycle metrics to the database for dashboard tracking and performance analysis. Stores PnL, win rate, positions, budget usage, and notes. Call this after each automated trading cycle.","write_action":false,"price_micros":0,"input_schema":null},{"name":"config.go_live","description":"Switch from preview (simulated) to live trading mode where real orders are placed on Polymarket. Requires API credentials configured in environment. This action uses real money.","write_action":false,"price_micros":0,"input_schema":null},{"name":"config.safety_limits","description":"Configure trading safety guardrails: maximum order size in USDC, total exposure cap, and maximum spread tolerance. These limits are enforced on all subsequent buy/sell operations. Changes persist in the database.","write_action":false,"price_micros":0,"input_schema":null},{"name":"config.set","description":"Update bot configuration at runtime. Supports daily_budget (max USDC per day) and min_conviction (minimum trade size to copy). Changes take effect immediately and persist across restarts.","write_action":true,"price_micros":0,"input_schema":null},{"name":"dashboard.get","description":"Get a comprehensive dashboard showing daily budget usage, total P&L, recent trades, watchlist status, and monitor state. No parameters needed. Use this for a quick overview of your trading activity.","write_action":false,"price_micros":0,"input_schema":null},{"name":"flow.discover","description":"Scan top leaderboard traders for smart money convergence signals. Identifies markets where multiple top traders are buying the same outcome simultaneously, indicating strong conviction.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.analyze","description":"Generate a BUY/SELL/HOLD recommendation for a Polymarket market by analyzing price, spread, price trend, and liquidity depth. Returns a score with detailed reasoning. Read-only analysis, does not place trades.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.arbitrage","description":"Scan active Polymarket markets for arbitrage opportunities where YES + NO prices don't sum to $1.00. Returns markets with the price gap and potential profit percentage.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.check","description":"Evaluate market quality by checking bid/ask spread, order book depth, and price range. Returns a pass/fail with specific reasons. Use before placing trades to avoid illiquid or wide-spread markets.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.compare","description":"Compare 2-5 Polymarket markets side by side. Shows price, spread, order book depth, volume, and quality score for each market. Useful for choosing the best market to trade among similar options.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.discover","description":"Find active Polymarket prediction markets filtered by resolution deadline and category. Returns market question, price, volume, and end date. Use ending='today' for fast-resolving markets, or 'all' to browse everything.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.events","description":"Browse Polymarket event groups to find all markets under a single event (e.g. 'US Election', 'UFC 300', 'NBA Finals'). Returns the event with all its sub-markets and their current prices.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.featured","description":"List top Polymarket markets ranked by liquidity with optional category filter (politics, sports, crypto, pop-culture, business, science). Returns the most liquid and actively traded markets.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.holders","description":"View the largest position holders in a Polymarket market by condition_id. Shows wallet address, position size, and side (YES/NO). Useful for gauging smart money sentiment on a market.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.price","description":"Get live bid/ask/spread prices from the CLOB order book for a specific market by condition_id. If no condition_id is given and show_positions is true, returns current prices for all open positions.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.price_history","description":"Fetch historical OHLC price data for a market token over a configurable time window (1h to 1m). Returns price points with a sparkline visualization showing the price trend.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.related","description":"Find Polymarket markets related to a given condition_id or topic keyword. Useful for discovering correlated markets or building a diversified position across related events.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.search","description":"Search Polymarket markets by keyword query. Returns matching markets with question, price, volume, and condition_id. Use the condition_id from results with buy, get_price, or analyze_opportunity.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.trending","description":"List trending Polymarket markets ranked by trading volume over a configurable period (24h, 7d, or 30d). Filter by category to focus on specific topics. Returns market question, price, and volume.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.watch","description":"Manage your market watchlist: add, remove, or list watched markets with optional price alert thresholds. When a market crosses your alert price, it shows up in check_exits.","write_action":false,"price_micros":0,"input_schema":null},{"name":"markets.watch_price","description":"Manage live WebSocket price subscriptions for real-time market updates. Subscribe to a token_id to start streaming price changes, unsubscribe to stop, or check connection status.","write_action":false,"price_micros":0,"input_schema":null},{"name":"monitor.start","description":"Start a background loop that polls watched wallets for new trades and automatically copies them. Runs continuously at the specified interval until stop_monitor is called. Requires at least one wallet on the watchlist.","write_action":false,"price_micros":0,"input_schema":null},{"name":"monitor.stop","description":"Stop the background wallet monitoring loop started by monitor.start. Call this to end a copy-trading session, before changing bot configuration via config.set or config.safety_limits, or when switching between preview and live modes via config.go_live. Does NOT close open positions — use positions.close or positions.set_exit_rules separately to unwind trades. Idempotent: safe to call when the moni","write_action":false,"price_micros":0,"input_schema":null},{"name":"orders.batch","description":"Execute multiple buy/sell orders in a single call (max 10 orders). Each order specifies a condition_id, amount, optional price, and side. Returns per-order results with success/failure status.","write_action":true,"price_micros":0,"input_schema":null},{"name":"orders.buy","description":"Buy outcome shares on a Polymarket market. Specify condition_id, USDC amount, and optionally a limit price. Runs a market quality check before executing. In preview mode, simulates the trade. In live mode, places a real CLOB order.","write_action":true,"price_micros":0,"input_schema":null},{"name":"orders.cancel","description":"Cancel ALL open/pending limit orders on Polymarket for this account in a single call. Use as an emergency stop, before changing strategy, after a sudden price move, or when unwinding positions. Not reversible — cancelled orders must be re-placed via orders.buy, wta.bid, or orders.batch. Returns the count of cancelled orders. Call orders.list first if you want to preview what will be cancelled. Onl","write_action":true,"price_micros":0,"input_schema":null},{"name":"orders.list","description":"List all open (pending/unfilled) limit orders currently resting on Polymarket's order book for this account. Use after placing limit orders via orders.buy or wta.bid to confirm acceptance, or before orders.cancel to preview what will be removed. Returns each order's ID, market question, side (BUY/SELL), size, limit price, and age. For deeper detail on a single order, call orders.status with its or","write_action":false,"price_micros":0,"input_schema":null},{"name":"orders.sell","description":"Sell an open position by trade_id (from get_positions) or condition_id. In live mode, places a sell order on Polymarket. In preview mode, marks the position as sold in the database and calculates realized P&L.","write_action":false,"price_micros":0,"input_schema":null},{"name":"orders.status","description":"Check the live state of a specific Polymarket limit order by its order_id. Use after orders.buy, orders.batch, or wta.bid to track fill progress, or to verify that an orders.cancel call succeeded. Returns the order status (OPEN, FILLED, CANCELLED, or EXPIRED), filled amount, remaining size, current limit price, and the market it was placed on. Obtain the order_id from the response of the placing t","write_action":false,"price_micros":0,"input_schema":null},{"name":"portfolio.balance","description":"View account balance summary: daily budget remaining, total invested, realized and unrealized P&L. No parameters needed. Use this to check how much budget is left before placing new trades.","write_action":false,"price_micros":0,"input_schema":null},{"name":"portfolio.get","description":"Get a comprehensive portfolio overview of all open copy-trading positions, grouped by the source trader they were copied from, with per-wallet subtotals, individual market names/entry prices/sizes, active stop-loss/take-profit rules, and an aggregate total P&L. Use as a daily status check, before sizing decisions via config.set, or to identify which source wallet is carrying the portfolio. Returns","write_action":false,"price_micros":0,"input_schema":null},{"name":"portfolio.optimize","description":"Analyze your open positions and generate optimization recommendations based on your chosen strategy (conservative, balanced, or aggressive). Returns SL/TP suggestions, concentration warnings, and cut/hold/take-profit actions for each position.","write_action":false,"price_micros":0,"input_schema":null},{"name":"portfolio.risk","description":"Assess portfolio risk across 4 dimensions: position concentration, market diversification, stop-loss/take-profit coverage, and daily budget utilization. Returns a risk score with specific warnings. No parameters needed.","write_action":false,"price_micros":0,"input_schema":null},{"name":"positions.check_exits","description":"Scan all open positions for exit conditions: market resolution, stop-loss/take-profit triggers, or the original trader exiting. Updates P&L and closes positions that meet exit criteria. No parameters needed.","write_action":false,"price_micros":0,"input_schema":null},{"name":"positions.close","description":"Manually close a copy trading position by trade ID. In live mode, places a sell order on Polymarket. In preview mode, marks the position as closed in the database. Use get_positions to find the trade_id.","write_action":false,"price_micros":0,"input_schema":null},{"name":"positions.list","description":"View your own copy trading positions filtered by status (open, closed, or all). Returns market name, entry price, current price, P&L, and exit rules for each position.","write_action":false,"price_micros":0,"input_schema":null},{"name":"positions.set_exit_rules","description":"Set stop-loss and/or take-profit price levels on an open position. When the market price crosses these levels, check_exits will automatically close the position. Use get_positions to find trade IDs.","write_action":false,"price_micros":0,"input_schema":null},{"name":"traders.analyze","description":"Analyze a Polymarket trader by wallet address. Returns profile stats, active positions, win rate, volume, PnL, and recent trade activity. Use before adding a trader to your watchlist to assess their quality.","write_action":false,"price_micros":0,"input_schema":null},{"name":"traders.backtest","description":"Simulate copying a trader's historical trades to calculate hypothetical P&L. Shows what you would have earned if you had copy-traded this wallet. Use before adding a trader to your watchlist to validate their performance.","write_action":false,"price_micros":0,"input_schema":null},{"name":"traders.discover","description":"Fetch top traders from the Polymarket leaderboard ranked by PnL, volume, and ROI. Use this to find profitable traders worth copying. Returns trader address, PnL, volume, and win rate. Use auto_watch to add them to your watchlist directly.","write_action":false,"price_micros":0,"input_schema":null},{"name":"traders.positions","description":"View another trader's current open positions on Polymarket by their wallet address. Shows market name, outcome, size, and current price. Useful for due diligence before copy trading.","write_action":false,"price_micros":0,"input_schema":null},{"name":"traders.score","description":"Calculate a conviction score (0-100) for a trader across 5 dimensions: win rate, volume, consistency, experience, and diversity. Higher scores indicate more reliable traders for copy trading.","write_action":false,"price_micros":0,"input_schema":null},{"name":"trades.history","description":"Retrieve past copy trades from the database with optional filters by trader address or status. Returns trade details including entry price, P&L, and market info.","write_action":false,"price_micros":0,"input_schema":null},{"name":"watchlist.add","description":"Add or remove an Ethereum wallet address from the copy trading watchlist. Watched wallets are monitored for new trades when the monitor is running. Use discover_traders first to find good wallets to watch.","write_action":false,"price_micros":0,"input_schema":null},{"name":"watchlist.list","description":"Show every wallet address currently on the copy-trading watchlist, with its alias, date added, and active/paused status. Use to review who is being copied before calling monitor.start, after watchlist.rebalance to confirm removals, or to pick a target for traders.analyze, traders.positions, or traders.score. Returns a markdown table of watched wallets. Call watchlist.add to manage entries, or trad","write_action":false,"price_micros":0,"input_schema":null},{"name":"watchlist.rebalance","description":"Analyze all traders on your watchlist and remove underperformers whose conviction score or win rate falls below your threshold. Use to keep your watchlist focused on high-quality traders.","write_action":false,"price_micros":0,"input_schema":null},{"name":"wta.bid","description":"Place limit orders (stink bids) at a discount on WTA tennis match favorites. Orders sit in the order book until filled at your target price. In preview mode, simulates the orders. In live mode, places real CLOB orders.","write_action":false,"price_micros":0,"input_schema":null},{"name":"wta.discover","description":"Find today's WTA tennis match markets on Polymarket where the favorite is available at a discount. Returns matches with current price vs fair price and the discount percentage. Use place_stink_bid to act on these opportunities.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":83,"grade":"B","scanned_at":"2026-09-24T05:04:15.719Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-24T05:04:15.722Z","components":{"code":{"score":25,"max":25,"notes":["149 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 0 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"polymarket-agent-mcp","version":"1.7.0","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":7,"publishedAt":"2026-08-07T01:05:06.270Z","repositoryUrl":"git+https://github.com/demwick/polymarket-agent-mcp.git","weeklyDownloads":66}],"repo":{"found":true,"owner":"demwick","repo":"polymarket-agent-mcp","archived":false,"pushedAt":"2026-09-24T01:34:19Z","stars":16,"forks":6,"openIssues":18,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/79982521?v=4","ownerCreatedAt":"2021-03-03T13:04:53Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/79982521?v=4&s=128","source":"github"},"presence":{"stars":16,"forks":6,"downloadsWeek":66,"license":"MIT","lastPushAt":"2026-09-24T01:34:19.000Z","score":39}}}},"grade_history":[],"reviews":[]}