POLYMARKET PERPETUALS MCP

Trade Perps
with your agent.

Connect your AI agent to Polymarket Perpetuals. Ask it to check prices, review your positions or place an order, all from the same conversation.

MARKET DATA · TRADING · ACCOUNT HISTORY
MCP ENDPOINT
Checking connection…

Add this address to your MCP client. You can start using public market data straight away.

SERVER URLhttps://api.mcp.polyperpetuals.xyz/mcp
WHAT YOU CAN DO

From a price check to a trade.

MCP lets your agent use Polymarket tools directly. You can ask for a market update, work through a trade or check how your account is doing.

01

Follow the market

Get prices, order books, recent trades and charts. Ask for a market by its symbol, like BTC or ETH.

02

Place and manage orders

Place market and limit orders, add stop losses and take profits, or change and cancel open orders.

03

Check your account

See balances, open positions, fills, fees and funding. Review recent trades and their PnL.

04

Plan a trade

Preview order size and margin, compare leverage settings or calculate a position size from your entry and stop.

EXAMPLE CONVERSATIONS

You ask. Your agent works through it.

Try these prompts in your connected LLM or AI agent. The replies below are illustrative, with sample prices and balances. Actual responses depend on live data, your account and your client’s chart support.

Check a price

Public data
YOU

What is the current price of BTC?

EXAMPLE AGENT REPLY

BTC’s mark price is $60,000. The best bid is $59,999 and the best ask is $60,001. These Polymarket quotes were updated at 14:32 UTC; your execution price may differ.

Explore a chart

Public data
YOU

Show the BTC chart for the last 24 hours.

EXAMPLE AGENT REPLY

Here are BTC’s hourly candles for the last 24 hours, with UTC timestamps. The period’s high is $61,200 and its low is $59,400. Would you like a shorter interval or a different range?

Review your positions

Account connection
YOU

Show my BTC position and its PnL.

EXAMPLE AGENT REPLY

You’re long 0.01 BTC at an entry price of $59,000. At the current mark of $60,000, your unrealized PnL is +$10, before fees and funding. This is an open position, so the PnL can still change.

Plan an order

Preview before signing
YOU

Preview a $600 BTC limit buy at $60,000 with a stop 2% below entry. Don’t submit it yet.

EXAMPLE AGENT REPLY

That’s $600 of notional, or 0.01 BTC, with a stop trigger at $58,800. The price move to the stop represents a $12 loss before fees and slippage. Entry-bracket protection activates only after a full entry fill. I’ll check size and margin requirements before preparing anything to sign. No order has been submitted.

Reduce a position

Account connection and signing
YOU

Prepare to close half my BTC position.

EXAMPLE AGENT REPLY

You’re long 0.01 BTC. I’ve prepared a reduce-only market sell for 0.005 BTC, leaving 0.005 BTC if fully filled. It needs your wallet signature before submission. After execution, I’ll check the fills and whether your existing stops still match the remaining position.

Clarify an action

Account connection
YOU

Sell all my BTC orders.

EXAMPLE AGENT REPLY

Do you want to cancel your pending BTC orders or close your open BTC position? Those are separate actions. I haven’t changed either.

CONNECT

Add Polyperpetuals to your agent.

MCP CLIENT CONFIGURATION
{
  "mcpServers": {
    "polyperpetuals": {
      "url": "https://api.mcp.polyperpetuals.xyz/mcp"
    }
  }
}
Use this configuration in a client that supports remote MCP servers over Streamable HTTP.

Start with market data.

Open your agent’s MCP settings and add the server URL, or copy the JSON into its configuration. Once connected, ask for the current BTC price to try it out.

Connect your account to trade.

Account access needs a registered Polymarket trading session. Connect a wallet integration that supports EIP-712 signing, then ask your agent to set up the session. It can then read your positions and prepare orders for that account.

Account access configuration

For account reads, add your registered session address and exchange read secret as HTTP headers in your client’s credential settings. Replace the placeholders below with the values returned during session registration.

ACCOUNT CONFIGURATION
{
  "mcpServers": {
    "polyperpetuals": {
      "url": "https://api.mcp.polyperpetuals.xyz/mcp",
      "headers": {
        "polymarket-proxy": "<REGISTERED_SESSION_ADDRESS>",
        "polymarket-secret": "<EXCHANGE_READ_SECRET>"
      }
    }
  }
}

Your client needs to support custom HTTP headers for account reads. Public market tools work without them.

Trading flow for developers

Create a trading session with perps_prepare_session. The owner wallet signs the returned CreateProxy message, and perps_submit_signature registers it. Store the returned account credentials in your client’s credential settings.

To place an order, call a perps_prepare_* tool, sign its EIP-712 data with the registered trading signer, then pass the action ID and signature to perps_submit_signature. Read orders, fills and positions for the result. Use perps_operation_status to look up a submission.

The agent handles strategy timing and repeated tasks. The MCP provides the tools and records its activity; it does not run trading loops.

Session documentation Trading documentation
DEPOSITS & WITHDRAWALS

Move funds into your Perps account.

Polymarket Perpetuals uses pUSD on Polygon. The MCP can prepare deposits, withdrawals and supported token conversions. The minimum Perps deposit is 10 pUSD.

DEPOSIT

Add pUSD

  1. Choose the amount of pUSD to deposit from your Polygon wallet.
  2. Your agent prepares the token approval and Perps deposit. Sign them with your wallet.
  3. The agent checks deposit history and reports your updated balance.
WITHDRAW

Withdraw to your wallet

  1. Ask your agent how much is available to withdraw.
  2. Choose an amount, then sign the withdrawal with your account’s owner wallet.
  3. The agent tracks the withdrawal until the pUSD arrives in your wallet.
Convert USDC and pUSD

For native USDC on Polygon, ask your agent for a bridge quote to pUSD. It checks supported assets, prepares the transfer and tracks the amount received. You can then deposit the pUSD into Perps.

After withdrawing from Perps, you can convert pUSD back to native USDC through the bridge. Quotes include the current minimum, costs and expiry.

USDC.e uses a separate wrapper. The MCP also supports wrapping USDC.e into pUSD and unwrapping pUSD back into USDC.e on Polygon.

The bridge tools are perps_bridge_supported_asset, perps_quote_bridge, perps_prepare_bridge_deposit and perps_prepare_bridge_withdrawal. Track transfers with perps_bridge_status and check receipts with perps_verify_bridge_receipt.

Smart wallets and contract addresses

For Deposit Wallets, Safes and Poly Proxies, use perps_relayer_capabilities to check availability, then perps_prepare_relayer to build the request. The owner wallet signs it, and perps_submit_relayer_signature sends it through Polymarket’s relayer. Sponsorship depends on the configured relayer access and quota. Regular wallets send transactions directly using Polygon gas.

Native USDC · bridge0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359
USDC.e · wrapper0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
CollateralOnramp0x93070a847efEf7F70739046A929D47a521F5B8ee
CollateralOfframp0x2957922Eb93258b93368531d39fAcCA3B4dC5854
PerpsDeposit0xDCa4af75705dbB50f62437045afF9921947917d2