# Papertrade

> Papertrade is a free MCP server for finance and payments. Paper-trading MCP server with virtual money across 45 stock markets. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://papertrade.world/docs
- **MCP Registry name:** world.papertrade/papertrade
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Each simulator is tied to one market, with that market's exchange hours, timezone and currency, and every fill is charged a chosen broker's intraday fees plus statutory charges such as India's STT or the US SEC fee. A live simulator trades real-time prices and only accepts orders while the exchange is open. A historic one replays a past trading day from a paused open, with replay speeds from 1x to 120x.

Orders can be market, limit, stop-market or stop-limit, with attached stop-loss and target exits, trailing stops, and shorting. Intraday leverage follows the broker, and Indian brokers auto square off positions at their cut-off. A results report covers net and gross P&L, charges, win rate, profit factor, day-by-day results and per-stock P&L, which is meant for judging an agent over weeks.

Sign-in uses OAuth 2.1, so Claude and ChatGPT need no key. Terminals and scripts can use a bearer key, and the same key works with Papertrade's REST API. Every call is logged on the Connect AI page.

## Features

- **45 markets:** Create simulators for markets from India and the US to Japan, Brazil and South Africa.
- **Real broker fees:** Fills include the chosen broker's commission and statutory charges.
- **Live or replay modes:** Trade real-time prices or replay a historic day at up to 120x.
- **Rich order types:** Market, limit, SL and SL-M orders, brackets and trailing stops.
- **Results report:** Win rate, profit factor, charges breakdown and daily streaks.
- **Call log:** Every agent call is recorded on the Connect AI page.

## Good for

- Test an AI trading agent's strategy without risking money
- Replay a past session to try an opening-range breakout
- Compare a model's results over several weeks of daily trading
- Check how broker fees and leverage change net P&L

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http papertrade https://papertrade.world/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://papertrade.world/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "papertrade": {
      "url": "https://papertrade.world/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "papertrade": {
      "type": "http",
      "url": "https://papertrade.world/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "papertrade": {
      "serverUrl": "https://papertrade.world/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "papertrade": {
      "type": "http",
      "url": "https://papertrade.world/api/mcp"
    }
  }
}
```

## Tools

- `market_status`: Data provider per market and whether each exchange is in session.
- `list_simulators`: Lists simulators with mode, replay clock, equity and P&L.
- `list_brokers`: Lists brokers whose fees can be simulated per market.
- `create_simulator`: Creates a paper-trading simulator for one market.
- `get_simulator`: Returns clock, funds, watchlist prices, positions and recent orders.
- `get_report`: Results report for a simulator.
- `delete_simulator`: Permanently deletes a simulator and its history.
- `search_instruments`: Searches stocks by symbol or company name in one market.
- `add_to_watchlist`: Tracks instruments in a simulator.
- `remove_from_watchlist`: Stops tracking an instrument.
- `place_order`: Places an intraday order with virtual money.
- `cancel_order`: Cancels an open order.
- `exit_positions`: Squares off one or all open positions at market.
- `control_replay`: Plays, pauses, changes speed or jumps a historic replay.

## FAQ

### Does it use real money?

No. Every tool works on your own simulators with virtual money.

### Is an account required?

Yes. A free account with email or Google sign-in and no card is needed.

### Which assistants work?

The docs give setup steps for Claude, ChatGPT, Gemini, Grok, Perplexity, Le Chat and any MCP app.

### Can I trade outside market hours?

Live simulators accept orders only while their exchange is open. Historic replays are not bound by that.

### Is Papertrade free?

Yes. Papertrade is free to use.

### How do I add Papertrade to Claude Code?

Run this command in your terminal: claude mcp add --transport http papertrade https://papertrade.world/api/mcp

### What are the best alternatives to Papertrade?

The closest alternatives to Papertrade are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/papertrade
