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

export PAPERAPIKEY=yourapikey
Optional override
export PAPERAPIBASE_URL=https://api.paperinvest.io

IDE Integrations

Cursor

{
  "mcpServers": {
    "paper": {
      "command": "paper-mcp-server",
      "env": {
        "PAPERAPIKEY": "yourapikey"
      }
    }
  }
}

Claude Desktop

Windows: %APPDATA%\Claude\claudedesktopconfig.json

{   "mcpServers": {     "paper": {       "command": "paper-mcp-server",       "env": {         "PAPERAPIKEY": "yourapikey"       }     }   } }

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

Examples

Configs and demo scripts are in examples/:

• examples/.cursor/mcp.json — Cursor integration
• examples/claude/claudedesktopconfig.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 PAPERAPIKEY is set in the same environment as your client.
• Restart Cursor/Claude after changing config.
• Check connectivity to https://api.paperinvest.io.

Links

• NPM: https://www.npmjs.com/package/@paperinvest/mcp-server
• GitHub: https://github.com/paperinvest/mcp-server
• MCP Landing: https://paperinvest.io/mcp
• API Docs: https://docs.paperinvest.io

Support

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

License

MIT © Paper Invest, Inc.