Labsco
polygon-io logo

Polygon.io

β˜… 360

from polygon-io

Access real-time and historical financial market data from Polygon.io's API.

πŸ”₯πŸ”₯πŸ”₯πŸ”₯βœ“ VerifiedAccount requiredNeeds API keys
<a href="https://massive.com"> <div align="center"> <picture> <source media="(prefers-color-scheme: light)" srcset="assets/logo-massive-lightmode.png"> <source media="(prefers-color-scheme: dark)" srcset="assets/logo-massive-darkmode.png"> <img alt="Massive.com logo" src="assets/logo-massive-lightmode.png" height="100"> </picture> </div> </a> <br>

[!IMPORTANT] :test_tube: This project is experimental and could be subject to breaking changes.

Massive.com MCP Server

GitHub release

A Model Context Protocol (MCP) server that provides access to the full Massive.com financial data API through an LLM-friendly interface.

Rather than exposing one tool per endpoint, this server gives the LLM three composable tools β€” search, call, and query β€” that cover the entire Massive.com API surface. Data can be stored in an in-memory SQLite database, and enriched with built-in financial functions.

Tools

ToolDescription
search_endpointsSearch for API endpoints and built-in functions by natural language query. Returns titles, path patterns, and descriptions. Set detail to "more" for query parameter docs, or "verbose" for full documentation. Use max_results to limit results.
call_apiCall any Massive.com REST API endpoint. Supports storing results as an in-memory database table (store_as) and applying post-processing functions (apply). Paginated responses include a next-page hint.
query_dataRun SQL against stored SQLite DB. Supports SHOW TABLES, DESCRIBE <table>, DROP TABLE <table>, CTEs, window functions, and more. Results can also be post-processed with apply.

Built-in Functions

Functions 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.

CategoryFunctions
Greeksbs_price, bs_delta, bs_gamma, bs_theta, bs_vega, bs_rho β€” Black-Scholes option pricing and greeks
Returnssimple_return, log_return, cumulative_return, sharpe_ratio, sortino_ratio
Technicalsma (simple moving average), ema (exponential moving average)

Data Coverage

The server dynamically indexes all Massive.com API endpoints at startup from llms.txt, so it automatically stays in sync with the API. Coverage includes:

  • Stock, options, forex, crypto, and futures aggregates
  • Real-time and historical trades and quotes
  • Market snapshots, gainers/losers
  • Ticker details and reference data
  • Dividends, splits, IPOs
  • Financial fundamentals
  • Analyst ratings and news (Benzinga)
  • Treasury yields, inflation data
  • Market status and holidays

Development

Running Locally

Check to ensure you have the Prerequisites installed.

Copy & paste β€” that's it
# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive
<details> <summary>Local Dev Config for claude_desktop_config.json</summary>

Install from your local checkout, then reference the binary directly:

Copy & paste β€” that's it
uv tool install --force /path/to/mcp_massive
Copy & paste β€” that's it
{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}
</details>

Debugging

For debugging and testing, we recommend using the MCP Inspector:

Copy & paste β€” that's it
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

This will launch a browser interface where you can interact with your MCP server directly and see input/output for each tool.

Select the STDIO transport type in the browser UI with the command uv and run mcp_massive as the arguments.

Code Linting

This project uses just for common development tasks. To lint your code before submitting a PR:

Copy & paste β€” that's it
just lint

This will run ruff format and ruff check --fix to automatically format your code and fix linting issues.

Links

Privacy Policy

This 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.

  • Massive.com Privacy Policy: https://massive.com/legal/privacy
  • Data Handling: This server does not store or cache any user data. All requests are proxied directly to Massive.com's API.
  • API Key: Your Massive.com API key is used only for authenticating requests to their API.
  • User-Agent: API requests include a User-Agent string containing the MCP server version (e.g., MCP-Massive/0.x.y). No personally identifiable information is included.

Contributing

If you found a bug or have an idea for a new feature, please first discuss it with us by submitting a new issue. We will respond to issues within at most 3 weeks. We're also open to volunteers if you want to submit a PR for any open issues but please discuss it with us beforehand. PRs that aren't linked to an existing issue or discussed with us ahead of time will generally be declined.

<!-----------------------------------------------------------------------------> <!---------------------------------[ Buttons ]--------------------------------->