Polymarket US MCP Integration for AI Agents | Composio

For AI agents: how to sign up

If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev.

Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.

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.

Get started for free Get a demo

Polymarket 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

Markdown

Polymarket US

Enter ↵

Try asking

List active Polymarket US election marketsShow my Polymarket US open positionsCheck Polymarket US market order books

TOOLS

Supported Tools

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

Tools44

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

TypeScript Python

Install Composio

typescript

Copy

npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp

Install the Composio SDK for Python or TypeScript

Initialize Client and Create Tool Router Session

typescript

Copy

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

Connect to AI Agent

typescript

Copy

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

TypeScript Python

Install Composio

typescript

Copy

npm install @composio/openai

Install the Composio SDK

Initialize Composio and Create Tool Router Session

typescript

Copy

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

Execute Polymarket US Tools via Tool Router with Your Agent

typescript

Copy

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

Claude Cowork
Use Polymarket US MCP with Claude Cowork](/content/toolkits/polymarket_us/framework/claude-cowork/index.html)
Codex
Use Polymarket US MCP with Codex](/content/toolkits/polymarket_us/framework/codex/index.html)

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Stripe

Api KeyOauth2

Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide.](/content/toolkits/stripe/index.html)

44API

Api Key

44API is an API service for validating VAT and tax identifiers and returning company details. Use it to verify business tax data and manage account IP whitelists quickly.](/content/toolkits/44api/index.html)

Aiwyn Tax MCP

No Auth

Aiwyn Tax MCP is a tax estimation service powered by Aiwyn's federal and state tax engine. It helps teams estimate tax outcomes without building tax calculation logic from scratch.](/content/toolkits/aiwyn_tax_mcp/index.html)

Alpaca

Api KeyOauth2

Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity.](/content/toolkits/alpaca/index.html)

FAQ

Frequently asked questions

Do I need my own developer credentials to use Polymarket US with Composio?+

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.

Can I use multiple toolkits together?+

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

Is Composio secure?+

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

What if the API changes?+

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.