What can you do with this server?

The Paper MCP Server enables interaction with Paper's trading platform via natural language, providing tools for: * **Account Management**: Create, update, freeze, and retrieve account details; upgrade to margin accounts. * **Portfolio Operations**: Create, reset, and manage portfolios and positions. * **Trading**: Place, modify, cancel, and manage orders, including batch orders. * **Market Data**: Access real-time quotes, market hours, and status information. * **Positions**: View current holdings and P\&L for equities and options. * **Activity Tracking**: Monitor trading activity and day trades.

Paper MCP Server (@paperinvest/mcp-server)

npm version npm downloads license

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.

Related MCP server: Flatfile MCP Server

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.

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.

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

Paper MCP Server