Skip to main content
Glama
Plydeen

Stock-MCP

by Plydeen
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

Tool

Description

get_stock_bars_csv

OHLCV bars for a stock via REST API

get_options_bars_csv

OHLCV bars for an options contract via REST API

get_flat_file_bars_csv

OHLCV bars from Massive Flat Files (S3 bulk data)

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

Research tools (JSON)

Tool

Description

search_tickers

Find symbols by name or ticker

get_ticker_details

Company / instrument metadata

get_stock_snapshot

Latest price snapshot (paid plan)

list_options_contracts

Options chain contract lookup

get_options_chain_snapshot

Full chain snapshot (paid plan)

list_flat_file_datasets

Flat file catalog and S3 listing

get_market_movers

Top gainers or losers (paid plan)

Related MCP server: market-data-mcp

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

Variable

Required

Description

MASSIVE_API_KEY

Yes

REST API key

MASSIVE_S3_ACCESS_KEY

Flat files only

S3 access key from Massive dashboard

MASSIVE_S3_SECRET_KEY

Flat files only

S3 secret key

MAX_CSV_ROWS

No

Row cap per CSV tool call (default 5000)

MCP_PORT

No

Host port for Docker (default 8082)

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Massive.com MCP Server

    dev-wraithgt60
    A
    license
    C
    quality
    D
    maintenance
    Provides access to comprehensive financial market data from Massive.com API, including real-time and historical data for stocks, options, forex, crypto, trades, quotes, market snapshots, ticker details, dividends, splits, fundamentals, and market status through an LLM-friendly interface.
    53
    MIT

  • market-data-mcp

    SmashToes
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
    -

  • polygon-mcp

    atomcp-ai
    A
    license
    C
    quality
    C
    maintenance
    Enables querying real-time and historical financial market data for stocks, options, forex, and crypto, including quotes, trades, technical indicators, and reference data through a set of MCP tools.
    71
    3
    MIT