How do I use Stock-MCP?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

Stock-MCP

by Plydeen

Overview Schema Source Related Servers Discussions Admin

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.

Create a remotely managed tunnel in Cloudflare Zero Trust.
Set CLOUDFLARE_TUNNEL_TOKEN in .env.
Add a public hostname route: mcp-stocks.yourdomain.com → http://stock-mcp:8080
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

Deploy the MCP server (local, VPS, or via Cloudflare Tunnel).
In a Claude Project, add a remote MCP server with your /mcp URL.
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

Rest_API_docs.md — Massive REST API
flat_files_docs.md — Massive Flat Files (S3)

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

Marketdata App A
io.github.pipeworx-io
Market Data App MCP — wraps the Market Data App API (marketdata.app)
Finance Cryptocurrency
481
https://gateway.pipeworx.io/marketdata-app/mcp
Polygon Io B
io.github.pipeworx-io
Massive (formerly Polygon.io) MCP.
Finance Cryptocurrency
563
https://gateway.pipeworx.io/polygon-io/mcp
outcometick A
io.github.outcometick
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
Blockchain Cryptocurrency Finance
711
https://outcometick.com/v1/mcp/public
Openfigi A
io.github.pipeworx-io
OpenFIGI MCP — financial-instrument symbology.
Finance Open Data Search
472
https://gateway.pipeworx.io/openfigi/mcp

Related MCP Servers

Massive.com MCP Server
Finance Search Data Platforms
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.
Updated 10 months ago (2026-01-05 02:40 UTC)
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.
Updated 9 months ago (2026-02-15 04:09 UTC)
-
polygon-mcp
Finance Cryptocurrency
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.
Updated 10 months ago (2025-12-25 22:28 UTC)
71
21 PyPI
3
MIT
polygon-io
Finance Research & Data
pipeworx-io
A
license
Not graded
quality
B
maintenance
Provides access to Polygon.io financial data including tickers, OHLC aggregates, daily open/close prices, and news via MCP gateway.
Updated 17 days ago (2026-10-17 21:21 UTC)
28 npm
MIT