Connect your AI agent to Papertrade.

Before you start

1. 1Create a free Papertrade account (email or Google; no card). Your agent acts as you, in your simulators.
2. 2Copy the server URL above: https://papertrade.world/api/mcp
3. 3Pick your AI app below and follow its steps. Most apps take about a minute.

Set up your AI app

AI assistants

Claudeclaude.ai, desktop & mobileChatGPTPlugins: custom MCP serverGeminiGemini app: custom appsGrokgrok.com connectorsPerplexityCustom MCP connectorLe ChatMistral: custom MCP connectorOther MCP appAny remote MCP client

Developer tools

Claude CodeTerminal & IDECodexCLI, IDE & ChatGPT desktopCursorAI code editorVS CodeGitHub Copilot agent modeWindsurfCascade agentAntigravityGoogle's agent app, IDE & CLIGemini CLIGoogle's terminal agent

Connect Claude

Open Claude Connectors

Opens the right screen in Claude. Claude doesn't let sites fill the form in, so follow the steps below.

1. 1

   In Claude, open Customize → Connectors (the button above goes straight there). Click + Add and choose Add custom connector.

2. 2

   Name it Papertrade, paste this server URL and click Continue:

   https://papertrade.world/api/mcpCopy
3. 3

   Under Authentication choose Sign in now, keep Use Claude's published identity as the OAuth client, leave Request headers empty and click Add.

4. 4

   A Papertrade page opens: sign in and click Allow.

5. 5

   In a chat, click + → Connectors and switch Papertrade on. Then ask it to trade.

Works on every Claude plan (Free allows one custom connector). On Team and Enterprise, an Owner adds it under Organization settings → Connectors, then members click Connect.

Sign in or API key

What your agent can do

Every tool works on your own simulators with virtual money. Each call is logged on the Connect AI page, and trades show up live on the simulator.

market_status

Data provider per market, whether the Kite session is connected, and whether each exchange (IN = NSE, US = NYSE) is in session right now. Live simulators accept orders only while their exchange is open — not on weekends, exchange holidays or outside regular hours.

list_simulators

List all trading simulators with mode, replay clock, equity and P&L.

list_brokers

Brokers whose fees can be simulated, per market: commission rule, whether statutory/regulatory charges apply (India: STT, exchange, SEBI, stamp, GST; US: SEC fee, FINRA TAF), max intraday leverage, and auto square-off time. Every market lists its major local brokers and apps; their fees and the market's transaction taxes (e.g. UK stamp duty, Hong Kong stamp duty) are applied on every fill.

create_simulator

Create a paper-trading simulator for one market (IN India, US United States, CA Canada, BR Brazil, MX Mexico, AR Argentina, CL Chile, GB United Kingdom, IE Ireland, DE Germany, FR France, NL Netherlands, BE Belgium, PT Portugal, IT Italy, ES Spain, CH Switzerland, AT Austria, SE Sweden, NO Norway, DK Denmark, FI Finland, PL Poland, CZ Czechia, HU Hungary, GR Greece, TR Türkiye, EE Estonia, IL Israel, SA Saudi Arabia, AE United Arab Emirates, QA Qatar, ZA South Africa, JP Japan, HK Hong Kong, CN China, TW Taiwan, KR South Korea, SG Singapore, MY Malaysia, TH Thailand, ID Indonesia, VN Vietnam, AU Australia, NZ New Zealand), each with its own exchange hours, timezone and currency — e.g. IN (NSE/BSE, ₹, 09:15–15:30 IST), US (NYSE/NASDAQ, $, 09:30–16:00 ET), GB (LSE, £), JP (Tokyo, ¥). mode 'live' trades on real-time prices and accepts orders only while the exchange is in session (not on weekends, exchange holidays or outside regular hours — see market_status); mode 'historic' replays a past trading day (needs date, starts paused at the open). Every fill is charged the chosen broker's intraday fees plus statutory charges; positions use the chosen intraday leverage (margin = order value ÷ leverage). Indian brokers auto square off open positions at their cut-off (e.g. Zerodha 3:20 PM) for a fee and refuse new orders after it; US brokers don't.

get_simulator

Full state of a simulator: clock, funds (equity, P&L, available margin), watchlist prices, positions and recent orders.

get_report

Results report for a simulator (use at the end of a session): net/gross P&L, charges breakdown, peak margin and leverage used, round-trip trades with win rate and profit factor, day-by-day results (daily: P&L per trading day, green vs red days, best/worst day, streaks; useful to judge an agent over weeks), per-stock P&L, who placed orders, equity curve and plain-language insights.

delete_simulator

Permanently delete a simulator and its history.

search_instruments

Search stocks by symbol or company name in one market (e.g. IN "NSE:INFY", US "US:AAPL", GB "LSE:HSBA", JP "TSE:7203", HK "HKEX:0700"). Returns exact symbols to use in other tools; use the simulator's market.

add_to_watchlist

Track one or more instruments in a simulator so their prices update on the dashboard.

remove_from_watchlist

Stop tracking an instrument (does not close positions).

place_order

Place an intraday order with virtual money. Types: MARKET fills now (replay time for historic); LIMIT rests until price reaches limitPrice; SL-M (stop-market) waits for triggerPrice then fills at market; SL (stop-limit) waits for triggerPrice then rests at limitPrice. A SELL stop's trigger must be below the current price (it triggers on the way down), a BUY stop's above. Protect a MARKET/LIMIT entry by attaching stopLoss and/or target prices: once the entry fills they become exit orders that cancel each other when one fills (and are cancelled if you close the position yourself). trailingStop {type: points|percent, value} makes the stop follow the best price; on an SL-M it trails the trigger. Selling without a position opens a short. Margin = order value ÷ leverage. Rejected after the broker's auto square-off time (see get_simulator.squareOff / ordersOpen).

cancel_order

Cancel an OPEN order: limit, stop-loss (SL / SL-M) or a bracket's stop-loss / target exit.

exit_positions

Square off a position at market, or all open positions if symbol is omitted.

control_replay

Historic simulators only: play, pause, set speed (1/2/5/10/30/60/120x) or jump the replay clock forward by N minutes.

Example prompts

• “Create a live US simulator called Momentum with $50,000 on Robinhood.”
• “Replay 12 October 2026 on NSE at 30× and trade the opening range breakout.”
• “Buy 10 TSLA with a stop loss 2% below and a target 4% above.”
• “Close every position that's down more than 1% today.”
• “How did you do this week? Show win rate, profitable days and fees.”
• “Trade my India simulator every day: max 3 positions, exit everything by 3 pm.”

Troubleshooting

The sign-in page doesn't open

Look for a Connect, Authenticate or Login button next to Papertrade in your app's MCP settings, or run its auth command (for example claude mcp login papertrade or /mcp auth papertrade). Pop-up blockers can stop it too.

Claude or ChatGPT can't reach the server

They connect from the cloud: use the server URL exactly as shown in the docs, including /api/mcp, and check that the connector is switched on in your chat.

I don't see Add custom MCP server in ChatGPT

It depends on your plan and workspace. On Business and Enterprise, ask an admin to allow or add custom MCP plugins. It isn't in the mobile app yet.

Orders are rejected

Live simulators only accept orders while their exchange is open (and before the broker's square-off). Replays trade any time. The rejection message says why.

The tools disappeared

Reconnect from your app's MCP settings. If you revoked the app or deleted its API key on the Connect AI page, add it again.

Security and access

• • Agents can only reach your Papertrade simulators. Nothing connects to a real broker, and all money is virtual.
• • Every tool call is recorded with the app that made it, so you can review what your AI did and when.
• • Revoke an app or delete a key any time on the Connect AI page: access stops immediately.
• • API keys are stored as a one-way hash (plus an encrypted copy so you can copy them again). See the privacy policy.