Paper MCP Server

Connect AI coding assistants to Paper's Trading API via the Model Context Protocol (MCP). Query quotes, place paper orders, inspect portfolios, and more—directly from your IDE or chat.

Install

Package	`npm i -g @paperinvest/mcp-server`
Node	Node.js 16+ recommended

Quickstart

Step	Command	Expected result
1	`export PAPER_API_KEY=your_api_key`	API key available to the MCP server
2	`paper-mcp-server`	MCP server starts and registers with your client
3	In Cursor/Claude: `paper.quote("AAPL")`	Returns NBBO quote for AAPL
4	In Cursor/Claude: paper.order({ symbol: "AAPL", side: "buy", quantity: 10, type: "market" })	Places a simulated market order

Configure

Provide your Paper API credentials via environment variables (or a .env file) so the MCP server can authenticate to the Paper API.

Environment

# Required
PAPER_API_KEY=your_api_key
# Optional overrides
PAPER_API_BASE_URL=https://api.paperinvest.io

Run (CLI)

paper-mcp-server

IDE Integrations

Client Config

Cursor (mcpServers)

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "paper": {
      "command": "paper-mcp-server",
      "env": {
        "PAPER_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Desktop

# ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "paper": {
      "command": "paper-mcp-server",
      "env": {
        "PAPER_API_KEY": "your_api_key"
      }
    }
  }
}

Tools Reference

Tool	Description
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 the full list on GitHub: mcp-server#tools

Ready to use Paper with MCP?

Install the package, add your API key, and start issuing trading commands from your AI assistant.