{"id":32791784,"url":"https://github.com/massive-com/mcp_massive","last_synced_at":"2026-03-09T22:10:41.974Z","repository":{"id":290002535,"uuid":"951563472","full_name":"massive-com/mcp_massive","owner":"massive-com","description":"An MCP server for Massive.com Financial Market Data","archived":false,"fork":false,"pushed_at":"2026-03-09T14:17:21.000Z","size":381,"stargazers_count":261,"open_issues_count":21,"forks_count":73,"subscribers_count":11,"default_branch":"master","last_synced_at":"2026-03-09T18:55:37.417Z","etag":null,"topics":["cryptocurrency","fintech","llm","market-data","mcp","mcp-server","options","stocks"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/massive-com.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-19T22:05:09.000Z","updated_at":"2026-03-06T15:15:55.000Z","dependencies_parsed_at":"2025-04-26T08:55:39.637Z","dependency_job_id":"f1228701-52ed-48b9-9c8a-65cc446926be","html_url":"https://github.com/massive-com/mcp_massive","commit_stats":null,"previous_names":["polygon-io/mcp_polygon","massive-com/mcp_massive"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/massive-com/mcp_massive","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/massive-com%2Fmcp_massive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/massive-com%2Fmcp_massive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/massive-com%2Fmcp_massive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/massive-com%2Fmcp_massive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/massive-com","download_url":"https://codeload.github.com/massive-com/mcp_massive/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/massive-com%2Fmcp_massive/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30314613,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T20:05:46.299Z","status":"ssl_error","status_checked_at":"2026-03-09T19:57:04.425Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cryptocurrency","fintech","llm","market-data","mcp","mcp-server","options","stocks"],"created_at":"2025-11-05T14:01:04.328Z","updated_at":"2026-03-09T22:10:41.966Z","avatar_url":"https://github.com/massive-com.png","language":"Python","readme":"\u003ca href=\"https://massive.com\"\u003e\n  \u003cdiv align=\"center\"\u003e\n    \u003cpicture\u003e\n        \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"assets/logo-massive-lightmode.png\"\u003e\n        \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"assets/logo-massive-darkmode.png\"\u003e\n        \u003cimg alt=\"Massive.com logo\" src=\"assets/logo-massive-lightmode.png\" height=\"100\"\u003e\n    \u003c/picture\u003e\n  \u003c/div\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\n\u003e [!IMPORTANT]\n\u003e :test_tube: This project is experimental and could be subject to breaking changes.\n\n# Massive.com MCP Server\n\n [![GitHub release](https://img.shields.io/github/v/release/massive-com/mcp_massive)](https://github.com/massive-com/mcp_massive/releases)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides access to the full [Massive.com](https://massive.com?utm_campaign=mcp\u0026utm_medium=referral\u0026utm_source=github) financial data API through an LLM-friendly interface.\n\nRather than exposing one tool per endpoint, this server gives the LLM four composable tools — **search**, **docs**, **call**, and **query** — that cover the entire Massive.com API surface. Data can be stored in-memory as DataFrames, queried with SQL, and enriched with built-in financial functions.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `search_endpoints` | Search for API endpoints and built-in functions by natural language query. Returns names, URL patterns, and descriptions. Supports scoping to `endpoints`, `functions`, or `all`. |\n| `get_endpoint_docs` | Get parameter documentation for a specific endpoint. Pass the docs URL from `search_endpoints` results. |\n| `call_api` | Call any Massive.com REST API endpoint. Supports storing results as an in-memory DataFrame (`store_as`) and applying post-processing functions (`apply`). Paginated responses include a next-page hint. |\n| `query_data` | Run SQL against stored DataFrames using SQLite. Supports `SHOW TABLES`, `DESCRIBE \u003ctable\u003e`, `DROP TABLE \u003ctable\u003e`, CTEs, window functions, and more. Results can also be post-processed with `apply`. |\n\n### Built-in Functions\n\nFunctions can be applied to API results or query output via the `apply` parameter on `call_api` and `query_data`. Use `search_endpoints` with `scope=\"functions\"` to discover them.\n\n| Category | Functions |\n|---|---|\n| **Greeks** | `bs_price`, `bs_delta`, `bs_gamma`, `bs_theta`, `bs_vega`, `bs_rho` — Black-Scholes option pricing and greeks |\n| **Returns** | `simple_return`, `log_return`, `cumulative_return`, `sharpe_ratio`, `sortino_ratio` |\n| **Technical** | `sma` (simple moving average), `ema` (exponential moving average) |\n\n### Data Coverage\n\nThe server dynamically indexes all Massive.com API endpoints at startup from [`llms.txt`](https://massive.com/docs/rest/llms.txt), so it automatically stays in sync with the API. Coverage includes:\n\n- Stock, options, forex, crypto, and futures aggregates\n- Real-time and historical trades and quotes\n- Market snapshots, gainers/losers\n- Ticker details and reference data\n- Dividends, splits, IPOs\n- Financial fundamentals\n- Analyst ratings and news (Benzinga)\n- Treasury yields, inflation data\n- Market status and holidays\n\n## Installation\n\n### Prerequisites\n\n- Python 3.12+\n- A Massive.com API key \u003cbr\u003e [![Button]][Link]\n- [Astral UV](https://docs.astral.sh/uv/getting-started/installation/) (v0.4.0+)\n\n### Claude Code\nFirst, install [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)\n\n```bash\nnpm install -g @anthropic-ai/claude-code\n```\n\nInstall the MCP server, then register it with Claude Code:\n\n```bash\n# Install the server (one-time — downloads dependencies ahead of time)\nuv tool install \"mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.8.3\"\n\n# Register with Claude Code\nclaude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive\n```\n\nTo upgrade to a new version later:\n\n```bash\nuv tool upgrade mcp_massive\n```\n\n\u003e [!NOTE]\n\u003e **Upgrading from `uvx` or `uv run --with`?** Previous versions recommended `uvx --from ... mcp_massive` or `uv run --with`. These commands download dependencies on every cold start, which can cause the server to exceed Claude's 30-second connection timeout. Switch to `uv tool install` as shown above — it downloads dependencies once and starts instantly after that.\n\nThis command will install the MCP server in your current project.\nIf you want to install it globally, you can run the command with `-s \u003cscope\u003e` flag.\nSee `claude mcp add --help` for more options.\n\nTo start Claude Code, run `claude` in your terminal.\n- If this is your first time using, follow the setup prompts to authenticate\n\nYou can also run `claude mcp add-from-claude-desktop` if the MCP server is installed already for Claude Desktop.\n\n### Claude Desktop\n\n1. Follow the [Claude Desktop MCP installation instructions](https://modelcontextprotocol.io/quickstart/user) to complete the initial installation and find your configuration file.\n1. Install the server:\n\n```bash\nuv tool install \"mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.8.3\"\n```\n\n3. Find the installed binary path:\n\n```bash\n# Mac/Linux\nwhich mcp_massive\n\n# Windows\nwhere mcp_massive\n```\n\n4. Add the server to your Claude Desktop config. Replace `\u003cpath_to_mcp_massive\u003e` with the output from the previous step, and fill in the remaining fields.\n\n\u003cdetails\u003e\n  \u003csummary\u003eclaude_desktop_config.json\u003c/summary\u003e\n\n```json\n{\n    \"mcpServers\": {\n        \"massive\": {\n            \"command\": \"\u003cpath_to_mcp_massive\u003e\",\n            \"env\": {\n                \"MASSIVE_API_KEY\": \"\u003cyour_api_key_here\u003e\",\n                \"HOME\": \"\u003cyour_home_directory\u003e\"\n            }\n        }\n    }\n}\n```\n\u003c/details\u003e\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `MASSIVE_API_KEY` | Yes | — | Your Massive.com API key |\n| `POLYGON_API_KEY` | No | — | Deprecated alias for `MASSIVE_API_KEY` |\n| `MCP_TRANSPORT` | No | `stdio` | Transport protocol: `stdio`, `sse`, or `streamable-http` |\n| `MASSIVE_API_BASE_URL` | No | `https://api.massive.com` | Base URL for API requests |\n| `MASSIVE_LLMS_TXT_URL` | No | `https://massive.com/docs/rest/llms.txt` | URL for the endpoint index |\n| `MASSIVE_MAX_TABLES` | No | `50` | Maximum number of in-memory DataFrames |\n| `MASSIVE_MAX_ROWS` | No | `50000` | Maximum rows per stored DataFrame |\n\n### Transport\n\nBy default, STDIO transport is used. The transport can be set via the `--transport` CLI argument or the `MCP_TRANSPORT` environment variable (CLI argument takes precedence).\n\n```bash\n# CLI argument\nMASSIVE_API_KEY=\u003cyour_api_key_here\u003e uv run mcp_massive --transport streamable-http\n\n# Environment variable\nMCP_TRANSPORT=streamable-http MASSIVE_API_KEY=\u003cyour_api_key_here\u003e uv run mcp_massive\n```\n\n## Usage Examples\n\nOnce integrated, you can prompt Claude to access Massive.com data:\n\n```\nGet the latest price for AAPL stock\nShow me yesterday's trading volume for MSFT\nWhat were the biggest stock market gainers today?\nGet me the latest crypto market data for BTC-USD\nCalculate the 20-day SMA for AAPL closing prices over the last 3 months\nCompute Black-Scholes delta for these option contracts\n```\n\n## Development\n\n### Running Locally\n\nCheck to ensure you have the [Prerequisites](#prerequisites) installed.\n\n```bash\n# Sync dependencies\nuv sync\n\n# Run the server\nMASSIVE_API_KEY=your_api_key_here uv run mcp_massive\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eLocal Dev Config for claude_desktop_config.json\u003c/summary\u003e\n\nInstall from your local checkout, then reference the binary directly:\n\n```bash\nuv tool install --force /path/to/mcp_massive\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"massive\": {\n      \"command\": \"mcp_massive\",\n      \"env\": {\n        \"MASSIVE_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n### Debugging\n\nFor debugging and testing, we recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):\n\n```bash\nnpx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive\n```\n\nThis will launch a browser interface where you can interact with your MCP server directly and see input/output for each tool.\n\n### Code Linting\n\nThis project uses [just](https://github.com/casey/just) for common development tasks. To lint your code before submitting a PR:\n\n```bash\njust lint\n```\n\nThis will run `ruff format` and `ruff check --fix` to automatically format your code and fix linting issues.\n\n## Links\n- [Massive.com Documentation](https://massive.com/docs?utm_campaign=mcp\u0026utm_medium=referral\u0026utm_source=github)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n- [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)\n\n## Privacy Policy\n\nThis MCP server interacts with Massive.com's API to fetch market data. All data requests are subject to Massive.com's privacy policy and terms of service.\n\n- **Massive.com Privacy Policy**: https://massive.com/legal/privacy\n- **Data Handling**: This server does not store or cache any user data. All requests are proxied directly to Massive.com's API.\n- **API Key**: Your Massive.com API key is used only for authenticating requests to their API.\n\n## Contributing\nIf you found a bug or have an idea for a new feature, please first discuss it with us by submitting a new issue.\nWe will respond to issues within at most 3 weeks.\nWe're also open to volunteers if you want to submit a PR for any open issues but please discuss it with us beforehand.\nPRs that aren't linked to an existing issue or discussed with us ahead of time will generally be declined.\n\n\u003c!-----------------------------------------------------------------------------\u003e\n[Link]: https://massive.com/?utm_campaign=mcp\u0026utm_medium=referral\u0026utm_source=github 'Massive.com Home Page'\n\u003c!---------------------------------[ Buttons ]---------------------------------\u003e\n[Button]: https://img.shields.io/badge/Get_One_For_Free-5F5CFF?style=for-the-badge\u0026logoColor=white\n","funding_links":[],"categories":["Stock Market","Finance","Finance \u0026 Market Data Mcp Servers","📚 Projects (1974 total)","Finance \u0026 Fintech"],"sub_categories":["Data Providers","Stock Data \u0026 Analytics","MCP Servers"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmassive-com%2Fmcp_massive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmassive-com%2Fmcp_massive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmassive-com%2Fmcp_massive/lists"}