Polymarket US MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Polymarket US MCP or direct API to explore active markets, inspect order books, review positions, and place market actions through natural language.

Polymarket US logoPolymarket US
Api Key

Polymarket US is the CFTC-compliant Polymarket product for verified United States users. Use it to access regulated prediction market data and account workflows through official API credentials.

44 Tools

Try Polymarket US now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Polymarket US
Try asking
TOOLS

Supported Tools

Every Polymarket US action and event your agent gets out of the box.

Cancel All Open Orders

Cancel all authenticated Polymarket US open orders, optionally scoped to specific market slugs.

Cancel Multiple Orders

Cancel up to 20 Polymarket US open orders in one request.

Cancel Order

Cancel one Polymarket US open order by exchange-assigned order ID.

Close Position Order

Create a live Polymarket US order intended to close an existing position in one market.

Create Multiple Orders

Submit up to 20 live Polymarket US orders in one request.

Create Order

Submit one live Polymarket US order.

Get Account Balances

Get the authenticated user's Polymarket US account balances.

Get Activities

Get authenticated Polymarket US portfolio activities such as trades, resolutions, deposits, withdrawals, referral bonuses, and transfers.

Get Event By ID

Get one Polymarket US event by numeric ID from the public gateway API.

Get Event By Slug

Get one Polymarket US event by slug from the public gateway API.

Get League By Slug

Get a current Polymarket US v2 league by slug.

Get Market BBO

Get the best bid and offer for one Polymarket US market by slug.

Get Market Book

Get the public order book for one Polymarket US market by slug.

Get Market By ID

Get one Polymarket US market by numeric ID from the public gateway API.

Get Market By Slug

Get one Polymarket US market by slug from the public gateway API.

Get Market Settlement

Get settlement information for one Polymarket US market by slug.

Get Markets For Subject

Discover Polymarket US markets associated with a subject ID.

Get Markets For Subject By Slug

Discover Polymarket US markets associated with a subject slug.

Get Open Orders

Get all open orders for the authenticated Polymarket US user.

Get Order

Get an authenticated user's Polymarket US order by exchange-assigned order ID.

Get Series By ID

Get a Polymarket US series by numeric ID.

Get Sport By Slug

Get a current Polymarket US v2 sport by slug.

Get Subject By ID

Get a Polymarket US subject entity by numeric ID.

Get Subject By Slug

Get a Polymarket US subject entity by slug.

Get Tag By ID

Get a Polymarket US topic, sport, or league tag by numeric ID.

Get Tag By Slug

Get a Polymarket US topic, sport, or league tag by slug.

Get User Positions

Get the authenticated user's Polymarket US trading positions across all markets or filtered by a specific market slug.

List Events

Discover Polymarket US events from the public gateway API.

List Events For League

List Polymarket US events for a current v2 league slug such as "nba" or "nfl".

List Events For Series

List Polymarket US sports events for a legacy v1 series ID.

List Events For Sport

List Polymarket US events for a current v2 sport slug such as "football" or "basketball".

List Featured Tags

List featured Polymarket US tag sections from the public gateway API.

List Leagues

List current Polymarket US sports leagues from the v2 public gateway API.

List Markets

Discover Polymarket US markets from the public gateway API.

List Series

List Polymarket US series from the public gateway API.

List Sports

List Polymarket US sports from the current v2 public gateway API.

List Sports Teams

List Polymarket US sports teams from the legacy v1 public gateway API.

List Sports Teams For Provider

List Polymarket US legacy v1 sports team mappings for a data provider.

List Subjects

List Polymarket US subject entities from the public gateway API.

List Tags

List ranked Polymarket US tags from the public gateway API.

Modify Multiple Orders

Modify up to 20 Polymarket US open orders in one request.

Modify Order

Modify one existing Polymarket US open order.

Preview Order

Preview a Polymarket US order without submitting it to the market.

Search Markets And Events

Search public Polymarket US markets and events for discovery.

SETUP GUIDE

Connect Polymarket US MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Polymarket US
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List active Polymarket US markets and summarize the top-volume contracts'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Polymarket US API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Polymarket US Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List active Polymarket US markets and summarize the top-volume contracts'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Polymarket US actions with your Agent

Why Use Composio?

AI Native Polymarket US Integration

  • Supports both Polymarket US MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable market lookup, portfolio review, and trading workflows
  • Rich coverage for querying Polymarket US data and taking account-specific actions after user approval

Secure API Key Auth

  • Connect Polymarket US API keys created at https://polymarket.us/developers after account verification
  • Central place to manage, scope, and revoke Polymarket US access
  • Per user and per environment credentials instead of hard-coded keys in agent code

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear schemas help agents understand Polymarket US market, order, and account operations
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Polymarket US
  • Scoped, least privilege access to Polymarket US resources
  • Full audit trail of agent actions to support review, compliance, and production monitoring
FRAMEWORKS

Use Polymarket US with any AI Agent Framework

Choose a Framework you want to connect Polymarket US with

FAQ

Frequently asked questions

Yes, Polymarket US requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Polymarket US.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Polymarket US tool your agent needs.Free to start.

Start building