https://github.com/imbenrabi/financial-modeling-prep-mcp-server
A Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.
https://github.com/imbenrabi/financial-modeling-prep-mcp-server
ai etf-investments financial-modeling-prep fmp llm mcp mcp-server mcp-tools smithery-ai stock-data stock-market
Last synced: 3 months ago
JSON representation
A Model Context Protocol (MCP) implementation for Financial Modeling Prep, enabling AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights.
- Host: GitHub
- URL: https://github.com/imbenrabi/financial-modeling-prep-mcp-server
- Owner: imbenrabi
- License: apache-2.0
- Created: 2025-05-22T14:01:13.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-29T16:53:15.000Z (6 months ago)
- Last Synced: 2026-01-30T04:55:39.628Z (6 months ago)
- Topics: ai, etf-investments, financial-modeling-prep, fmp, llm, mcp, mcp-server, mcp-tools, smithery-ai, stock-data, stock-market
- Language: TypeScript
- Homepage:
- Size: 1.13 MB
- Stars: 106
- Watchers: 2
- Forks: 45
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- toolsdk-mcp-registry - ❌ financial-modeling-prep - time and historical financial data across stocks, company profiles, financial statements, technical indicators, and economic information for investment research and market analysis. (node) (Finance & Fintech / How to Submit)
README
# Financial Modeling Prep MCP Server
[](https://www.npmjs.com/package/financial-modeling-prep-mcp-server)
[](LICENSE)
A Model Context Protocol (MCP) server for the [Financial Modeling Prep](https://financialmodelingprep.com/) API, exposing 250+ financial data tools to AI assistants.
## Features
- **250+ Financial Tools** across 24 categories — stocks, ETFs, crypto, forex, commodities, economics, and more
- **Dynamic Tool Management** — built on [toolception](https://www.npmjs.com/package/toolception) for runtime enable/disable of toolsets via meta-tools
- **Three Server Modes** — Dynamic (meta-tools), Static (pre-loaded toolsets), or All Tools (default)
- **Flexible Deployment** — use the hosted instance or self-host via npm, Docker, or source
- **HTTP/SSE Transport** — compatible with Claude.ai, Claude Desktop, and MCP registries
## Quick Start
### Hosted Instance (Fastest)
No installation required. Connect directly:
```
https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp
```
Provide your `FMP_ACCESS_TOKEN` in session configuration and start using 5 meta-tools to load toolsets on demand.
### Self-Hosted (One-Liner)
```bash
npx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY
```
Or install globally:
```bash
npm install -g financial-modeling-prep-mcp-server
fmp-mcp --fmp-token=YOUR_FMP_API_KEY
```
> Get your API key at [financialmodelingprep.com](https://site.financialmodelingprep.com/).
## Table of Contents
- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [API Reference](docs/API_REFERENCE.md)
- [Registries](docs/REGISTRIES.md)
- [Contributing](CONTRIBUTING.md)
- [License](LICENSE)
## Installation
**Prerequisites:** Node.js 25.3.0 or higher (for v2.6.0+). For older versions (v2.5.x and below), Node.js 20+ is required.
Choose the method that fits your workflow:
- **NPM** — `npm install -g financial-modeling-prep-mcp-server`
- **Docker** — build from source or pull a pre-built image
- **Source** — clone and run with `npm install && npm run build`
See [docs/INSTALLATION.md](docs/INSTALLATION.md) for detailed steps per method.
## Configuration
The server supports three operational modes controlled via CLI arguments, environment variables, or session configuration:
| Mode | How to Enable | Description |
|------|---------------|-------------|
| **Dynamic** | `DYNAMIC_TOOL_DISCOVERY=true` | Starts with 5 meta-tools; load toolsets at runtime |
| **Static** | `FMP_TOOL_SETS=search,company` | Pre-loads specified toolsets on session creation |
| **All Tools (default)** | *(default)* | Loads all 250+ tools immediately |
Precedence: CLI args > Environment variables > Session config > Defaults.
See [docs/CONFIGURATION.md](docs/CONFIGURATION.md) for the full configuration reference.
## Usage
Connect to the server via HTTP/SSE transport:
- **Claude.ai / Claude Desktop** — add as a remote connector (Settings > Connectors)
- **Custom clients** — POST to `/mcp` with `mcp-client-id` header
- **MCP registries** — Smithery.ai, Glama.ai, and others
See [docs/USAGE.md](docs/USAGE.md) for client-specific setup, session headers, and request examples.
## Available Tools
24 categories covering:
Search · Directory & Symbol Lists · Company Information · Financial Statements · Financial Metrics & Analysis · Technical Indicators · Quotes & Price Data · Market Indexes & Performance · Market Data · News & Press Releases · SEC Filings · Insider & Institutional Trading · ETFs & Funds · Government Trading · Cryptocurrency & Forex · Earnings · Special Data Sets · Commodities · Economics · Bulk Data Tools
See [docs/API_REFERENCE.md](docs/API_REFERENCE.md) for the complete tool catalog.
## Registries
This server is listed on multiple MCP registries for easy discovery:
- [Smithery.ai](https://smithery.ai/server/@imbenrabi/financial-modeling-prep-mcp-server)
- [Glama.ai](https://glama.ai/mcp/servers/@imbenrabi/financial-modeling-prep-mcp-server)
See [docs/REGISTRIES.md](docs/REGISTRIES.md) for registry-specific setup instructions.
## Contributing
Contributions are welcome. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and pull request guidelines.
## License
[Apache-2.0](LICENSE)