Massive MCP Server (CSV + Charts)

Standalone FastMCP server that exposes Massive (Polygon) market data to Claude and other MCP clients. Chart tools return chart-ready CSV; lookup tools return compact JSON.

Tools

CSV / chart tools

CSV columns: datetime,open,high,low,close,volume,transactions

Research tools (JSON)

Related MCP server: Massive.com MCP Server

Local Setup

cd Stock-MCP
python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

Edit .env:

MASSIVE_API_KEY=your_rest_api_key
MASSIVE_S3_ACCESS_KEY=your_flat_files_access_key   # optional, for flat files
MASSIVE_S3_SECRET_KEY=your_flat_files_secret_key

Run locally:

fastmcp run app/mcp_server.py --transport http --host 127.0.0.1 --port 8082

MCP endpoint:

http://127.0.0.1:8082/mcp

Docker on Linux VPS

cp .env.example .env
# edit .env
docker compose -f deploy/docker-compose.yml up -d --build

The service binds to localhost:

http://127.0.0.1:8082/mcp

Cloudflare Tunnel (optional)

Expose the MCP server to Claude Projects without opening a public port on the VPS.

1. Create a remotely managed tunnel in Cloudflare Zero Trust.

2. Set CLOUDFLARE_TUNNEL_TOKEN in .env.

3. Add a public hostname route: mcp-stocks.yourdomain.com → http://stock-mcp:8080

4. Start with the tunnel profile:

docker compose -f deploy/docker-compose.yml --profile tunnel up -d --build

Claude remote MCP URL:

https://mcp-stocks.yourdomain.com/mcp

Claude Integration

1. Deploy the MCP server (local, VPS, or via Cloudflare Tunnel).

2. In a Claude Project, add a remote MCP server with your /mcp URL.

3. Add to your project instructions:

For charts, call get_stock_bars_csv or get_flat_file_bars_csv and parse the csv field. Always mention truncated and the date range in your analysis.

Environment Variables

Testing

pytest tests/ -v

Optional integration tests (requires real API keys in .env):

RUN_INTEGRATION=1 pytest tests/test_integration.py -v

Security

• Keep .env off Git; use chmod 600 .env on the VPS.

• Bind to 127.0.0.1 unless behind Cloudflare Tunnel or nginx.

• Do not log API keys.

• Consider Cloudflare WAF rate limiting on the public MCP hostname.

API Reference Docs

• Rest_API_docs.md — Massive REST API

• flat_files_docs.md — Massive Flat Files (S3)