by paperinvest
Enables AI assistants to interact with Paper's trading API, fetching real‑time quotes, placing simulated orders, and inspecting portfolio positions and P&L.
Paper MCP Server provides a Model Context Protocol (MCP) endpoint that lets AI coding assistants such as Cursor or Claude call Paper's trading API directly from their prompts. It bridges natural‑language interactions with market data, order execution, and portfolio analytics in a paper‑trading environment.
npx:
npx -y @paperinvest/mcp-server --help
(or install globally with npm i -g @paperinvest/mcp-server).export PAPER_API_KEY=your_api_key # required
# optional override
export PAPER_API_BASE_URL=https://api.paperinvest.io
paper-mcp-server is provided by the package). The process will listen on the default MCP port and be discoverable by IDE integrations.mcp.json file to Cursor or Claude Desktop as shown in the README. The file points to the paper-mcp-server command and supplies the same environment variables.paper.quote(symbol)).npx and environment‑based configuration.Q: Do I need a real brokerage account? A: No. The server works with Paper’s paper‑trading API, which simulates market activity.
Q: Which Node version is required? A: Node.js 16+ is recommended.
Q: Can I run the server locally behind a firewall?
A: Yes. As long as the environment variable PAPER_API_KEY is set and outbound HTTPS to api.paperinvest.io is allowed, the server will function.
Q: How do I update the server?
A: Run npm i -g @paperinvest/mcp-server again or use npx -y @paperinvest/mcp-server to fetch the latest version.
Q: What if I get "command not found"?
A: Ensure the global npm prefix is in your PATH (npm prefix -g can help) or always invoke via npx as shown above.
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.
# 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.
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
File: ~/.cursor/mcp.json
{
"mcpServers": {
"paper": {
"command": "paper-mcp-server",
"env": {
"PAPER_API_KEY": "your_api_key"
}
}
}
}
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"
}
}
}
}
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&LSee more tools and examples in the repository and on the MCP landing: https://paperinvest.io/mcp
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 orderpaper-mcp-server is in your PATH (npm prefix -g may help).PAPER_API_KEY is set in the same environment as your client.https://api.paperinvest.io.For support, visit paperinvest.io or email support@paperinvest.io
MIT © Paper Invest, Inc.
Please log in to share your review and rating for this MCP.
{
"mcpServers": {
"paper": {
"command": "npx",
"args": [
"-y",
"@paperinvest/mcp-server"
],
"env": {
"PAPER_API_KEY": "<YOUR_API_KEY>"
}
}
}
}claude mcp add paper npx -y @paperinvest/mcp-serverExplore related MCPs that share similar capabilities and solve comparable challenges
by stripe
Integrates Stripe's APIs into LLM‑driven agent workflows via Python and TypeScript libraries, exposing tool definitions compatible with Model Context Protocol for seamless function calling.
by goat-sdk
Enables AI agents to send and receive payments, purchase goods and services, execute investment strategies, tokenize assets, and obtain financial insights by leveraging blockchains, stablecoins, and wallets.
by financial-datasets
Provides access to income statements, balance sheets, cash flow statements, stock prices, market news, and cryptocurrency data through MCP tools for AI assistants.
by alpacahq
Enables large language models to trade stocks and options, retrieve real‑time and historical market data, and manage portfolios using plain English commands through a local or remote MCP server.
by XeroAPI
Provides a bridge between the Model Context Protocol and Xero's API, enabling standardized access to Xero accounting and business features.
by stefanoamorelli
Provides an MCP server that connects AI models to SEC EDGAR filings, enabling real‑time retrieval of company filings, financial statements, and insider‑trading data with exact XBRL precision and verifiable filing references.
by ariadng
Enables AI LLMs to execute trades on the MetaTrader 5 platform through the Model Context Protocol.
by calvernaz
Provides access to Alpha Vantage stock market data via an MCP server, supporting stdio and HTTP streaming modes with optional OAuth 2.1 authentication.
by kukapay
Integrates the Freqtrade cryptocurrency trading bot with MCP, exposing its REST API as tools for AI agents to perform automated trading operations.