Paper

Paper

Official MCP server enabling AI assistants to fetch quotes, place paper orders, and inspect portfolios.

17
Stars
4
Forks
0
Releases

Overview

Official MCP server for Paper's trading platform enabling AI coding assistants (Cursor, Claude, and others) to interact with the Paper Trading API. It exposes MCP endpoints to fetch real-time quotes, place simulated orders (market, limit, stop), and inspect portfolios and P&L. The server can be installed globally (npm i -g @paperinvest/mcp-server) or run with npx, with Node.js 16+ recommended. Configure authentication via environment variables: PAPER_API_KEY and optional PAPER_API_BASE_URL to point to the Paper API. IDE integrations are supported: Cursor uses a JSON config at ~/.cursor/mcp.json and Claude Desktop uses claude_desktop_config.json with a 'paper' MCP server entry and the API key. Tools available include paper.quote, paper.quotesBatch, paper.order, and paper.portfolio. Example scripts and configs are in the examples directory, showing prompts to fetch quotes and place orders. Getting started steps include signing up at app.paperinvest.io, generating an API key, configuring the environment, and restarting Claude Desktop or Cursor. Troubleshooting covers PATH issues, ensuring API key is set in the correct environment, connectivity to https://api.paperinvest.io, and restarting clients after config changes. Links to NPM, GitHub, MCP landing, and API docs are provided.

Details

Owner
paperinvest
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

Official MCP server for Paper trading platform

Official MCP server enabling AI assistants to interact with Paper Trading API for quotes, orders, and portfolio inspection.

Real-time quotes access

Provides real-time NBBO quotes via paper.quote(symbol) for single-symbol queries.

Batch quotes

Fetch quotes for multiple symbols in a single request with paper.quotesBatch(symbols[]).

Simulated order placement

Place simulated orders (market, limit, stop) using paper.order({ ... }).

Portfolio and P&L retrieval

Retrieve portfolio positions and P&L with paper.portfolio(id).

CLI install and runtime

Install globally for CLI usage or run with npx: paper-mcp-server --help.

Environment-based configuration

Configure via PAPER_API_KEY and optional PAPER_API_BASE_URL to connect to the Paper API.

IDE integration support

Includes configuration samples for Cursor and Claude Desktop to connect to the MCP server.

Audience

AI developersIntegrate AI assistants with the Paper Trading API to quote, trade, and monitor portfolios.
Product teamsTest and showcase AI-assisted paper trading workflows using the Paper MCP server.
CLI/DevOps engineersRun the MCP server locally, configure API keys, and integrate into CI workflows.

Tags

MCPMCP serverPaperpaper tradingAI integrationquotesportfolioordersCursorClaude