Lets an AI client search Massive.com's financial API endpoints, call them, and run SQL on stored market data.
Also known as massive-com/mcp_massive, mcp-massive
- Stars
- 402
- Tools
- 3
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 3, 2026
- License
- MIT
What is Massive.com MCP?
Massive.com lets an AI client search Massive.com's financial API endpoints, call them, and run SQL on stored market data. It exposes 3 tools, such as search_endpoints, call_api, query_data.
Summary generated from the project's README
About Massive.com MCP server
Financial analysts and developers can access comprehensive market data directly through their AI clients using this server. It provides a bridge to the Massive.com API, covering stocks, options, forex, crypto, and futures. Instead of managing hundreds of individual endpoints, users interact with three primary tools: search_endpoints for finding specific data paths, call_api for fetching real-time or historical information, and query_data for running SQL commands against an in-memory SQLite database.
To use this server, you need a Massive.com API key and a local installation via Python and uv, or you can connect to a hosted version. The server allows you to store API results in local tables and apply built-in mathematical functions like Black-Scholes option pricing, Sharpe ratios, or moving averages directly to your datasets. This setup enables complex financial modeling and data analysis within a single conversational interface.
What you can do with it
- 1Analyze option pricingAsk the AI to calculate Black-Scholes greeks for specific option contracts.
- 2Perform technical analysisRequest a calculation of moving averages for a stock's historical closing prices.
- 3Query market trendsUse SQL to analyze stored market data and identify top performing assets.
- 4Discover API capabilitiesSearch for specific financial data endpoints using natural language.
Written from the project's README. Every use case is checked against a quote from it.
Massive.com MCP tools 3
Detected from the READMEsearch_endpointscall_apiquery_data
| search_endpoints | — | |
| call_api | — | |
| query_data | — |
Configuration
MASSIVE_API_KEYMCP_TRANSPORT
| Name | Description | |
|---|---|---|
| MASSIVE_API_KEY | — | |
| MCP_TRANSPORT | — |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHub[!IMPORTANT] :test_tube: This project is experimental and could be subject to breaking changes.
Massive.com MCP Server
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.
[!TIP] Don't want to install anything? Massive hosts this server at
https://mcp.massive.com. See the AI Tools quickstart for setup in each client.
Tools
| Tool | Description |
|---|---|
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. |
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. |
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. |
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.
| Category | Functions |
|---|---|
| Greeks | bs_price, bs_delta, bs_gamma, bs_theta, bs_vega, bs_rho — Black-Scholes option pricing and greeks |
| Returns | simple_return, log_return, cumulative_return, sharpe_ratio, sortino_ratio |
| Technical | sma (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
Installation
Prerequisites
- Python 3.12+
- A Massive.com API key
- Astral UV (v0.4.0+)
Claude Code
First, install Claude Code
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
uvxoruv run --with? Previous versions recommendeduvx --from ... mcp_massiveoruv run --with. These commands download dependencies on every cold start, which can cause the server to exceed Claude's 30-second connection timeout. Switch touv tool installas 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
- Follow the Claude Desktop MCP installation instructions to complete the initial installation and find your configuration file.
- Install the server:
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"
- Find the installed binary path:
# Mac/Linux
which mcp_massive
# Windows
where mcp_massive
- 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.
{
"mcpServers": {
"massive": {
"command": "<path_to_mcp_massive>",
"env": {
"MASSIVE_API_KEY": "<your_api_key_here>",
"HOME": "<your_home_directory>"
}
}
}
}
Configuration
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
MASSIVE_API_KEY |
Yes | — | Your Massive.com API key |
POLYGON_API_KEY |
No | — | Deprecated alias for MASSIVE_API_KEY |
MCP_TRANSPORT |
No | stdio |
Transport protocol: stdio, sse, or streamable-http |
MASSIVE_API_BASE_URL |
No | https://api.massive.com |
Base URL for API requests |
MASSIVE_LLMS_TXT_URL |
No | https://massive.com/docs/rest/llms.txt |
URL for the endpoint index |
MASSIVE_MAX_TABLES |
No | 50 |
Maximum number of in-memory tables |
MASSIVE_MAX_ROWS |
No | 50000 |
Maximum rows per stored tables |
Transport
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).
# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http
# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive
Usage Examples
Once integrated, you can prompt Claude to access Massive.com data:
Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contracts
Development
Running Locally
Check to ensure you have the Prerequisites installed.
# Sync dependencies
uv sync
# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive
Install from your local checkout, then reference the binary directly:
uv tool install --force /path/to/mcp_massive
{
"mcpServers": {
"massive": {
"command": "mcp_massive",
"env": {
"MASSIVE_API_KEY": "your_api_key_here"
}
}
}
}
Debugging
For debugging and testing, we recommend using the MCP Inspector:
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:
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.
Massive.com MCP questions
What tools does Massive.com MCP provide?
It exposes 3 tools, including search_endpoints, call_api, query_data.
What tools does the Massive MCP server provide?
It provides three composable tools: search_endpoints, call_api, and query_data, which together cover the entire Massive.com API surface.
What market data can I access through the Massive MCP server?
It covers stock, options, forex, crypto, and futures aggregates, trades and quotes, snapshots, fundamentals, dividends, splits, IPOs, analyst ratings, news, and treasury yields.
Do I need an API key to use the Massive MCP server?
Yes. You must set the MASSIVE_API_KEY environment variable with your Massive.com API key.
Can the Massive MCP server run SQL queries on market data?
Yes. API results can be stored as an in-memory SQLite table and queried with SQL, including CTEs, window functions, SHOW TABLES, and DESCRIBE.