Skip to content
Back to search

mcp_massive

An MCP server for Massive.com Financial Market Data

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/massive-com--mcp-massive/badge.svg)](/listings/massive-com--mcp-massive)

HTML

<a href="/listings/massive-com--mcp-massive"><img src="/api/listings/massive-com--mcp-massive/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- Python 3.12+ - A Massive.com API key <br> [![Button]][Link] - [Astral UV](https://docs.astral.sh/uv/getting-started/installation/) (v0.4.0+)

Claude Code

First, install [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)

npm install -g @anthropic-ai/claude-code

Install the MCP server, then register it with Claude Code:

# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"

# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

To upgrade to a new version later:

uv tool upgrade mcp_massive

> [!NOTE] > **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.

This command will install the MCP server in your current project. If you want to install it globally, you can run the command with `-s <scope>` flag. See `claude mcp add --help` for more options.

To start Claude Code, run `claude` in your terminal. - If this is your first time using, follow the setup prompts to authenticate

You can also run `claude mcp add-from-claude-desktop` if the MCP server is installed already for Claude Desktop.

Claude Desktop

1. Follow the [Claude Desktop MCP installation instructions](https://modelcontextprotocol.io/quickstart/user) to complete the initial installation and find your configuration file. 1. Install the server:

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"

3. Find the installed binary path:

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive

4. Add the server to your Claude Desktop config. Replace `<path_to_mcp_massive>` with the output from the previous step, and fill in the remaining fields.

<details> <summary>claude_desktop_config.json</summary>

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 262 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <a href="https://massive.com">
  2. <div align="center">
  3. <picture>
  4. <source media="(prefers-color-scheme: light)" srcset="assets/logo-massive-lightmode.png">
  5. <source media="(prefers-color-scheme: dark)" srcset="assets/logo-massive-darkmode.png">
  6. <img alt="Massive.com logo" src="assets/logo-massive-lightmode.png" height="100">
  7. </picture>
  8. </div>
  9. </a>
  10. <br>
  11. > [!IMPORTANT]
  12. > :test_tube: This project is experimental and could be subject to breaking changes.
  13. # Massive.com MCP Server
  14. [![GitHub release](https://img.shields.io/github/v/release/massive-com/mcp_massive)](https://github.com/massive-com/mcp_massive/releases)
  15. A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides access to the full [Massive.com](https://massive.com?utm_campaign=mcp&utm_medium=referral&utm_source=github) financial data API through an LLM-friendly interface.
  16. 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.
  17. > [!TIP]
  18. > Don't want to install anything? Massive hosts this server at `https://mcp.massive.com`.
  19. > See the [AI Tools quickstart](https://massive.com/docs/ai-tools/quickstart?utm_campaign=mcp&utm_medium=referral&utm_source=github) for setup in each client.
  20. ## Tools
  21. | Tool | Description |
  22. |---|---|
  23. | `search_endpoints` | Search 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. |
  24. | `call_api` | Call 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. |
  25. | `query_data` | Run 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`. |
  26. ### Built-in Functions
  27. 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.
  28. | Category | Functions |
  29. |---|---|
  30. | **Greeks** | `bs_price`, `bs_delta`, `bs_gamma`, `bs_theta`, `bs_vega`, `bs_rho` — Black-Scholes option pricing and greeks |
  31. | **Returns** | `simple_return`, `log_return`, `cumulative_return`, `sharpe_ratio`, `sortino_ratio` |
  32. | **Technical** | `sma` (simple moving average), `ema` (exponential moving average) |
  33. ### Data Coverage
  34. The 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:
  35. - Stock, options, forex, crypto, and futures aggregates
  36. - Real-time and historical trades and quotes
  37. - Market snapshots, gainers/losers
  38. - Ticker details and reference data
  39. - Dividends, splits, IPOs
  40. - Financial fundamentals
  41. - Analyst ratings and news (Benzinga)
  42. - Treasury yields, inflation data
  43. - Market status and holidays
  44. ## Installation
  45. ### Prerequisites
  46. - Python 3.12+
  47. - A Massive.com API key <br> [![Button]][Link]
  48. - [Astral UV](https://docs.astral.sh/uv/getting-started/installation/) (v0.4.0+)
  49. ### Claude Code
  50. First, install [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview)
  51. ```bash
  52. npm install -g @anthropic-ai/claude-code
  53. ```
  54. Install the MCP server, then register it with Claude Code:
  55. ```bash
  56. # Install the server (one-time — downloads dependencies ahead of time)
  57. uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"
  58. # Register with Claude Code
  59. claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive
  60. ```
  61. To upgrade to a new version later:
  62. ```bash
  63. uv tool upgrade mcp_massive
  64. ```
  65. > [!NOTE]
  66. > **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.
  67. This command will install the MCP server in your current project.
  68. If you want to install it globally, you can run the command with `-s <scope>` flag.
  69. See `claude mcp add --help` for more options.
  70. To start Claude Code, run `claude` in your terminal.
  71. - If this is your first time using, follow the setup prompts to authenticate
  72. You can also run `claude mcp add-from-claude-desktop` if the MCP server is installed already for Claude Desktop.
  73. ### Claude Desktop
  74. 1. Follow the [Claude Desktop MCP installation instructions](https://modelcontextprotocol.io/quickstart/user) to complete the initial installation and find your configuration file.
  75. 1. Install the server:
  76. ```bash
  77. uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"
  78. ```
  79. 3. Find the installed binary path:
  80. ```bash
  81. # Mac/Linux
  82. which mcp_massive
  83. # Windows
  84. where mcp_massive
  85. ```
  86. 4. Add the server to your Claude Desktop config. Replace `<path_to_mcp_massive>` with the output from the previous step, and fill in the remaining fields.
  87. <details>
  88. <summary>claude_desktop_config.json</summary>
  89. ```json
  90. {
  91. "mcpServers": {
  92. "massive": {
  93. "command": "<path_to_mcp_massive>",
  94. "env": {
  95. "MASSIVE_API_KEY": "<your_api_key_here>",
  96. "HOME": "<your_home_directory>"
  97. }
  98. }
  99. }
  100. }
  101. ```
  102. </details>
  103. ## Configuration
  104. ### Environment Variables
  105. | Variable | Required | Default | Description |
  106. |---|---|---|---|
  107. | `MASSIVE_API_KEY` | Yes | — | Your Massive.com API key |
  108. | `POLYGON_API_KEY` | No | — | Deprecated alias for `MASSIVE_API_KEY` |
  109. | `MCP_TRANSPORT` | No | `stdio` | Transport protocol: `stdio`, `sse`, or `streamable-http` |
  110. | `MASSIVE_API_BASE_URL` | No | `https://api.massive.com` | Base URL for API requests |
  111. | `MASSIVE_LLMS_TXT_URL` | No | `https://massive.com/docs/rest/llms.txt` | URL for the endpoint index |
  112. | `MASSIVE_MAX_TABLES` | No | `50` | Maximum number of in-memory tables |
  113. | `MASSIVE_MAX_ROWS` | No | `50000` | Maximum rows per stored tables |
  114. ### Transport
  115. By 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).
  116. ```bash
  117. # CLI argument
  118. MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http
  119. # Environment variable
  120. MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive
  121. ```
  122. ## Usage Examples
  123. Once integrated, you can prompt Claude to access Massive.com data:
  124. ```
  125. Get the latest price for AAPL stock
  126. Show me yesterday's trading volume for MSFT
  127. What were the biggest stock market gainers today?
  128. Get me the latest crypto market data for BTC-USD
  129. Calculate the 20-day SMA for AAPL closing prices over the last 3 months
  130. Compute Black-Scholes delta for these option contracts
  131. ```
  132. ## Development
  133. ### Running Locally
  134. Check to ensure you have the [Prerequisites](#prerequisites) installed.
  135. ```bash
  136. # Sync dependencies
  137. uv sync
  138. # Run the server
  139. MASSIVE_API_KEY=your_api_key_here uv run mcp_massive
  140. ```
  141. <details>
  142. <summary>Local Dev Config for claude_desktop_config.json</summary>
  143. Install from your local checkout, then reference the binary directly:
  144. ```bash
  145. uv tool install --force /path/to/mcp_massive
  146. ```
  147. ```json
  148. {
  149. "mcpServers": {
  150. "massive": {
  151. "command": "mcp_massive",
  152. "env": {
  153. "MASSIVE_API_KEY": "your_api_key_here"
  154. }
  155. }
  156. }
  157. }
  158. ```
  159. </details>
  160. ### Debugging
  161. For debugging and testing, we recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
  162. ```bash
  163. npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive
  164. ```
  165. This will launch a browser interface where you can interact with your MCP server directly and see input/output for each tool.
  166. Select the `STDIO` transport type in the browser UI with the command `uv` and `run mcp_massive` as the arguments.
  167. ### Code Linting
  168. This project uses [just](https://github.com/casey/just) for common development tasks. To lint your code before submitting a PR:
  169. ```bash
  170. just lint
  171. ```
  172. This will run `ruff format` and `ruff check --fix` to automatically format your code and fix linting issues.
  173. ## Links
  174. - [Massive.com Documentation](https://massive.com/docs?utm_campaign=mcp&utm_medium=referral&utm_source=github)
  175. - [Model Context Protocol](https://modelcontextprotocol.io)
  176. - [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)
  177. ## Privacy Policy
  178. 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.
  179. - **Massive.com Privacy Policy**: https://massive.com/legal/privacy
  180. - **Data Handling**: This server does not store or cache any user data. All requests are proxied directly to Massive.com's API.
  181. - **API Key**: Your Massive.com API key is used only for authenticating requests to their API.
  182. - **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.
  183. ## Contributing
  184. If you found a bug or have an idea for a new feature, please first discuss it with us by submitting a new issue.
  185. We will respond to issues within at most 3 weeks.
  186. We're also open to volunteers if you want to submit a PR for any open issues but please discuss it with us beforehand.
  187. PRs that aren't linked to an existing issue or discussed with us ahead of time will generally be declined.
  188. <!----------------------------------------------------------------------------->
  189. [Link]: https://massive.com/?utm_campaign=mcp&utm_medium=referral&utm_source=github 'Massive.com Home Page'
  190. <!---------------------------------[ Buttons ]--------------------------------->
  191. [Button]: https://img.shields.io/badge/Get_One_For_Free-5F5CFF?style=for-the-badge&logoColor=white

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.