whatisgithub

What is polymarket-mcp-server?

japp-fi/polymarket-mcp-server — explained in plain English

Analysis updated 2026-05-18

79TypeScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

An MCP server that lets AI assistants like Claude search, analyze, and optionally trade on Polymarket prediction markets.

Mindmap

mindmap
  root((Polymarket MCP))
    What it does
      Search markets
      Check odds
      Place trades
    Tech stack
      TypeScript
      Node.js
      MCP
    Use cases
      Research events
      Track prices
      Automate trading
    Audience
      Developers
      Traders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI assistant search Polymarket prediction markets and browse trending topics

USE CASE 2

Check current prices, order books, and trading volume for a prediction market through chat

USE CASE 3

Place, cancel, or manage trades on Polymarket directly from an AI coding tool

USE CASE 4

Try the server in demo mode without supplying wallet credentials

What is it built with?

TypeScriptNode.jsMCP

How does it compare?

japp-fi/polymarket-mcp-serverlongbridges/polymarket-kalshi-arbitrage-botshaya16/spent
Stars797979
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardmoderate
Complexity3/54/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Live trading requires a Polygon wallet private key, a demo mode works without one.

License is not specified in the description.

So what is it?

This is an MCP server, a standardized plug-in that lets AI assistants like Claude or Cursor interact with external services through a defined protocol, specifically connecting to Polymarket, a decentralized prediction market platform where people bet on the outcomes of real-world events. The server has two tiers of capability. The first tier is publicly available and requires no login: you can search for prediction markets, see trending topics, browse categories, inspect order books (the list of active bids and offers), and check prices and trading volume. The second tier requires wallet credentials and unlocks actual trading: placing and canceling orders, managing your portfolio positions, checking profit and loss, and approving token allowances. Under the hood, market discovery and analysis calls go through Polymarket's public HTTP APIs, while authenticated trading uses Polymarket's CLOB (Central Limit Order Book) client, which derives API credentials from a Polygon blockchain wallet's private key. The server runs as a stdio MCP process, meaning an AI coding tool connects to it and can then call Polymarket actions as if they were built-in tools. A developer or trader who wants their AI assistant to be able to look up current prediction market odds, research trending events, or even place trades programmatically would use this. It requires Node.js 18 or newer and is written in TypeScript. For live trading, a Polygon wallet private key must be supplied, a demo mode is available without wallet credentials.

Copy-paste prompts

Prompt 1
Help me connect japp-fi's polymarket-mcp-server to Claude so it can look up prediction market odds
Prompt 2
Explain the difference between the public and authenticated tiers in this MCP server
Prompt 3
Show me how to configure a Polygon wallet private key for live trading with this server
Prompt 4
Walk me through running this MCP server in demo mode without wallet credentials

Frequently asked questions

What is polymarket-mcp-server?

An MCP server that lets AI assistants like Claude search, analyze, and optionally trade on Polymarket prediction markets.

What language is polymarket-mcp-server written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

What license does polymarket-mcp-server use?

License is not specified in the description.

How hard is polymarket-mcp-server to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is polymarket-mcp-server for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.