Paper

v1.0.0Finance & Fintechstable

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.

aiai-assistantsclaudefinancemcp
Share:
21
Stars
0
Downloads
0
Weekly
0/5

What is Paper?

Paper is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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 conversati...

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.

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables AI assistants like Claude to interact with Paper's t

Use Cases

Trading platform API access
Portfolio and account management
Market data integration
paperinvest

Maintainer

LicenseMIT License
Languagejavascript
Versionv1.0.0
UpdatedMay 5, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx paper-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Paper

The Paper MCP server connects AI assistants like Claude to Paper's simulated trading platform API, enabling natural-language management of paper trading portfolios, order execution, and real-time market data retrieval. It exposes four core tools covering NBBO quote lookup (single and batch), simulated order placement (market, limit, and stop types), and portfolio position and P&L access. Traders learning options strategies or developers building algorithmic trading prototypes can use this server to interact with a risk-free simulated brokerage environment through conversational prompts.

Prerequisites

  • Node.js 16 or higher
  • An active Paper Trading account at paperinvest.io
  • A Paper API key generated from your account settings (PAPER_API_KEY)
  • An MCP-compatible client such as Claude Desktop
1

Install the Paper MCP server globally

Install the server package from npm to make the paper-mcp-server command available on your PATH.

npm install -g @paperinvest/mcp-server
2

Obtain your Paper API key

Log into paperinvest.io, navigate to Account Settings, and generate an API key. Copy it for use in the next step.

3

Test the server

Verify the server starts correctly with your API key by running it directly from the command line.

PAPER_API_KEY=your_api_key paper-mcp-server
4

Add to Claude Desktop configuration

Register the server in claude_desktop_config.json, passing your API key through the env block.

5

Restart Claude Desktop

Quit and relaunch Claude Desktop to load the new MCP server. The paper trading tools will appear in Claude's tool list.

Paper Examples

Client configuration

Claude Desktop configuration that launches the Paper MCP server with your API credentials.

{
  "mcpServers": {
    "paper": {
      "command": "paper-mcp-server",
      "args": [],
      "env": {
        "PAPER_API_KEY": "your-paper-api-key",
        "PAPER_API_BASE_URL": "https://api.paperinvest.io"
      }
    }
  }
}

Prompts to try

Example prompts for paper trading portfolio management, order execution, and market data retrieval.

- "Get the current NBBO quote for AAPL"
- "Fetch quotes for TSLA, NVDA, and MSFT at the same time"
- "Place a limit buy order for 10 shares of SPY at $540.00 in my portfolio"
- "Show me the current positions and P&L in my paper trading portfolio"
- "Place a stop-loss sell order for 5 shares of AMZN at $180.00"

Troubleshooting Paper

401 Unauthorized when placing orders or fetching quotes

Verify PAPER_API_KEY is set correctly in the env block. Log into paperinvest.io and regenerate the API key from Account Settings if you suspect it has expired or been revoked.

paper-mcp-server command not found after npm install

Ensure npm's global bin directory is on your PATH. Run 'npm config get prefix' to find the directory, then add <prefix>/bin to your PATH environment variable.

Order placement fails with a validation error

Confirm your paper trading account is active and funded with simulated cash on paperinvest.io. Market orders require a funded account even for simulated trading.

Frequently Asked Questions about Paper

What is Paper?

Paper is a Model Context Protocol (MCP) server that 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. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Paper?

Follow the installation instructions on the Paper GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Paper?

Paper works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Paper free to use?

Yes, Paper is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "paper-mcp-server": { "command": "npx", "args": ["-y", "paper-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Paper?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides