A
securityF
licenseA
qualityProvides AI assistants like Claude or Cursor with access to Payman AI's documentation, helping developers build integrations more efficiently.
Last updated -
5
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)
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 symbolpaper.quotesBatch(symbols[])— Get quotes for multiple symbols in one requestpaper.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 integrationexamples/claude/claude_desktop_config.json— Claude integrationexamples/scripts/get-quote.sh— Example prompt to fetch a quoteexamples/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-serveris in your PATH (npm prefix -gmay help).Verify
PAPER_API_KEYis set in the same environment as your client.Restart Cursor/Claude after changing config.
Check connectivity to
https://api.paperinvest.io.
Links
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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables AI assistants like Claude to interact with Paper's trading platform API using natural language, allowing users to manage accounts, portfolios, trades, and access market data through conversational requests.
- Install
- Configure
- IDE Integrations
- Tools Reference
- Examples
- Getting Started
- Troubleshooting
- Links
- Support
- License
Related Resources
Related MCP Servers
- -securityFlicense-qualityEnables AI assistants like Claude Desktop, Claude Code, and Cursor to interact directly with Flatfile data through 100+ API endpoints for viewing, managing, and manipulating sheets, workbooks, records, and spaces.Last updated -4
- -securityAlicense-qualityEnables large language models to interact with Alpaca's trading infrastructure using natural language, supporting stock/options trading, portfolio management, watchlist handling, and real-time market data access.Last updated -MIT License
- AsecurityFlicenseAqualityTransforms AI assistants into autonomous crypto trading agents with real-time market analysis, portfolio management, and trade execution across 17+ blockchains.Last updated -32617