by paperinvest
Enables AI coding assistants to interact with Paper's trading API, allowing real-time quote retrieval, simulated order placement, and portfolio inspection.
Enables AI assistants such as Cursor and Claude to call Paper's trading endpoints directly from code prompts. It acts as a bridge that translates model‑generated tool calls into HTTP requests against the Paper paper‑trading platform.
npx @paperinvest/mcp-server --help
(You can also install globally with npm i -g @paperinvest/mcp-server
.)export PAPER_API_KEY=your_api_key
# optional custom base URL
export PAPER_API_BASE_URL=https://api.paperinvest.io
The variables must be present in the same shell where the server is started.npx @paperinvest/mcp-server
~/.cursor/mcp.json
or Claude's desktop config) using the paper
name.paper.quote(symbol)
).Q: Which Node version is required? A: Node.js 16+ is recommended.
Q: Do I need to install the server globally?
A: No. Running with npx
is sufficient and avoids global installation.
Q: How do I change the API endpoint?
A: Set PAPER_API_BASE_URL
to the desired URL before starting the server.
Q: What if the server is not found in my PATH?
A: Verify the installation and ensure the npm global prefix (npm prefix -g
) is in your PATH, or always run via npx
.
Q: Can I use this server with other AI assistants?
A: Yes, any assistant that supports MCP can point to the same paper
server entry.
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": [ "@paperinvest/mcp-server" ], "env": { "PAPER_API_KEY": "<YOUR_API_KEY>" } } } }
Discover more MCP servers with similar functionality and use cases
by stripe
Enables popular agent frameworks to integrate with Stripe APIs via function calling, providing tools for MCP, Python, and TypeScript.
by goat-sdk
GOAT is the largest agentic finance toolkit for AI agents, enabling them to become economic actors by leveraging blockchains, cryptocurrencies, and wallets.
by financial-datasets
Provides AI assistants with tools to retrieve income statements, balance sheets, cash flow statements, stock prices, market news, and crypto information via the Model Context Protocol.
by razorpay
Enables seamless interaction with Razorpay APIs via Model Context Protocol, allowing developers and AI agents to capture payments, manage orders, process refunds, handle settlements, and more through a unified MCP interface.
by armorwallet
Armor Crypto MCP provides a unified interface for AI agents to interact with the crypto ecosystem, including wallet management, swaps, staking, and multi-chain operations.
by alpacahq
Alpaca’s MCP server lets you trade stocks and options, analyze market data, and build strategies through Alpaca's Trading API.
by XeroAPI
Provides a bridge between the Model Context Protocol and Xero's API, enabling standardized access to Xero accounting and business features.
by kukapay
Integrates the Freqtrade cryptocurrency trading bot with an MCP server, exposing the bot's REST API as tools that AI agents can call for fully automated trading operations.
by kukapay
Offers over 50 cryptocurrency technical analysis indicators and corresponding trading strategies, enabling AI agents and developers to assess market trends and generate buy, hold, or sell signals.