finance

Paper Invest▌

by paperinvest

Experience realistic stock trading with Paper Invest, the advanced stock trading simulator for authentic stock market si

Provides realistic paper trading capabilities through Paper Invest's API, enabling trade execution, portfolio management, and market analysis with authentic simulation including NBBO matching, slippage, partial fills, and broker-specific rules across 22 different platforms.

github stars

★ 19

GitHub Website npm

Authentic simulation with slippage and partial fills22 different broker platforms supportedReal-time market data integration

best for

/ Learning to trade without risking real money
/ Testing trading strategies and algorithms
/ Financial education and training
/ AI assistants helping with investment analysis

capabilities

/ Get real-time stock quotes and market data
/ Place simulated trades with market/limit/stop orders
/ Track portfolio positions and P&L
/ Fetch batch quotes for multiple symbols
/ Simulate authentic trading conditions with NBBO matching
/ Practice trading across 22 different broker platforms

what it does

Enables realistic paper trading simulations through an API, allowing you to practice trading with authentic market conditions including slippage and partial fills across 22 broker platforms.

about

Paper Invest is an official MCP server published by paperinvest that provides AI assistants with tools and capabilities via the Model Context Protocol. Experience realistic stock trading with Paper Invest, the advanced stock trading simulator for authentic stock market si It is categorized under finance.

how to install

You can install Paper Invest in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Paper Invest is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

Paper MCP Server (@paperinvest/mcp-server)

Official Model Context Protocol (MCP) server for Paper's trading platform. Lets AI coding assistants (Cursor, Claude, etc.) interact with the Paper Trading API to fetch quotes, place paper orders, and inspect portfolios.

Install

# Global install (recommended for CLI usage)
npm i -g @paperinvest/mcp-server

# Or run with npx
npx @paperinvest/mcp-server --help

Node.js 16+ recommended.

Configure

Set your Paper API credentials via environment variables (shell or .env).

export PAPER_API_KEY=your_api_key
# Optional override
export PAPER_API_BASE_URL=https://api.paperinvest.io

IDE Integrations

Cursor

File: ~/.cursor/mcp.json

{
  "mcpServers": {
    "paper": {
      "command": "paper-mcp-server",
      "env": {
        "PAPER_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "paper": {
      "command": "paper-mcp-server",
      "env": {
        "PAPER_API_KEY": "your_api_key"
      }
    }
  }
}

Tools Reference

paper.quote(symbol) — Get real-time NBBO quote for a symbol
paper.quotesBatch(symbols[]) — Get quotes for multiple symbols in one request
paper.order({ ... }) — Place a simulated order (market/limit/stop, etc.)
paper.portfolio(id) — Retrieve portfolio positions and P&L

See more tools and examples in the repository and on the MCP landing: https://paperinvest.io/mcp

Examples

Configs and demo scripts are in examples/:

examples/.cursor/mcp.json — Cursor integration
examples/claude/claude_desktop_config.json — Claude integration
examples/scripts/get-quote.sh — Example prompt to fetch a quote
examples/scripts/place-order.sh — Example prompt to place an order

Getting Started

Sign up at app.paperinvest.io
Generate an API key from your account settings
Add the configuration above with your API key
Restart Claude Desktop or Cursor

Troubleshooting

Ensure paper-mcp-server is in your PATH (npm prefix -g may help).
Verify PAPER_API_KEY is set in the same environment as your client.
Restart Cursor/Claude after changing config.
Check connectivity to https://api.paperinvest.io.

Support

For support, visit paperinvest.io or email support@paperinvest.io