QuantJourney MCP Server

Connect AI assistants (Claude Desktop, Cursor, Windsurf) to 500+ financial data tools from QuantJourney using the Model Context Protocol (MCP).

QuantJourney API offers a unified financial data platform that aggregates 40+ data providers (FMP, FRED, Yahoo Finance, SEC, CCXT, and more) into a single API and MCP. One account, one authentication — access to all providers.

Features

• 500+ Financial Tools — stocks, crypto, forex, commodities, fundamentals, macro

• 40+ Data Providers — FMP, FRED, Yahoo Finance, EOD, SEC, CCXT, and more

• Automatic Token Refresh — sessions stay alive without restarting

• API Key & Email Auth — use whichever suits your workflow

• Zero Configuration — .env file support, works out of the box

Quick Start

1. Prerequisites

• Python 3.10+

• QuantJourney account → Sign up

2. Install

git clone https://github.com/QuantJourneyOrg/mcp-server.git
cd mcp-server
pip install .

Or with requirements only:

pip install -r requirements.txt

3. Create .env File

QJ_MCP_EMAIL=your@email.com
QJ_MCP_PASSWORD=your-password

Or use an API key instead:

QJ_MCP_API_KEY=QJ_live_xxxxxxxxxxxxxxxx

4. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "quantjourney": {
      "command": "python",
      "args": ["/absolute/path/to/mcp-server/server.py"],
      "env": {
        "QJ_MCP_EMAIL": "your@email.com",
        "QJ_MCP_PASSWORD": "your-password"
      }
    }
  }
}

Tip: If you created a .env file, you can omit the env block entirely.

5. Restart Claude Desktop

Restart Claude and look for the MCP tools icon (🔧). Start asking financial questions!

Configuration

* Either email/password or API key is required.

Example Prompts

Once configured, try these in Claude:

Fundamentals & Valuation

• "Compare P/E ratios for AAPL, MSFT, and GOOGL"

• "Show me Tesla's revenue growth over the last 5 years"

• "Get Apple's latest balance sheet and calculate debt-to-equity"

Market Data

• "What are the top 10 S&P 500 performers this quarter?"

• "Show me the EURUSD exchange rate history for the past month"

• "Get the current options chain for NVDA"

Macro & Economics

• "Plot US GDP growth vs unemployment rate from FRED"

• "What's the latest CPI and inflation data?"

• "Compare interest rates across G7 countries from OECD"

Sentiment & Alternative

• "What's the CNN Fear & Greed index saying right now?"

• "Show me recent insider trading activity for META"

• "Get the latest 13F filings for Berkshire Hathaway from SEC"

Crypto

• "Compare Bitcoin and Ethereum performance this year"

• "What's the current BTC/USDT orderbook depth?"

See It in Action

📸 More examples with screenshots → EXAMPLES.md

Data Providers

Troubleshooting

"No tools loaded"

• Verify credentials in .env or Claude config

• Check you have an active QuantJourney subscription

• Look at stderr output for authentication errors

"Token expired" / tools stop working

• This should auto-resolve with v1.1.0's token refresh

• If persisting, restart Claude Desktop

Tools not appearing in Claude

• Restart Claude Desktop completely

• Verify the Python path in config is correct

• Check python server.py runs without errors from terminal

License

MIT License — see LICENSE

Links

• QuantJourney API

• MCP Documentation

• Sign Up

• Discord

• Changelog