Skip to content
Back to search

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.

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/imbenrabi--financial-modeling-prep-mcp-server/badge.svg)](/listings/imbenrabi--financial-modeling-prep-mcp-server)

HTML

<a href="/listings/imbenrabi--financial-modeling-prep-mcp-server"><img src="/api/listings/imbenrabi--financial-modeling-prep-mcp-server/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.

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)

npx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY

Or install globally:

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/).

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 · 118 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. # Financial Modeling Prep MCP Server
  2. [![npm version](https://img.shields.io/npm/v/financial-modeling-prep-mcp-server.svg)](https://www.npmjs.com/package/financial-modeling-prep-mcp-server)
  3. [![license](https://img.shields.io/npm/l/financial-modeling-prep-mcp-server.svg)](LICENSE)
  4. [![Listed on LightNow](https://lightnow.ai/badge/io.github.imbenrabi/financial-modeling-prep-mcp-server?variant=listed)](https://lightnow.ai/servers/io.github.imbenrabi/financial-modeling-prep-mcp-server)
  5. [![mcptry](https://mcptry.com/badge/io.github.imbenrabi/financial-modeling-prep-mcp-server)](https://mcptry.com/servers/io.github.imbenrabi/financial-modeling-prep-mcp-server)
  6. [![Financial Modeling Prep MCP on mcprush](https://mcprush.com/badge/financial-modeling-prep-mcp/score.svg)](https://mcprush.com/to/financial-modeling-prep-mcp?ref=badge)
  7. A Model Context Protocol (MCP) server for the [Financial Modeling Prep](https://financialmodelingprep.com/) API, exposing 267 financial data tools to AI assistants.
  8. ## Features
  9. - **267 Financial Tools** across 24 toolsets — stocks, ETFs, crypto, forex, commodities, economics, and more
  10. - **Dynamic Tool Management** — built on [toolception](https://www.npmjs.com/package/toolception) for runtime enable/disable of toolsets via meta-tools
  11. - **Three Server Modes** — Dynamic (5 meta-tools), Static (pre-loaded toolsets), or All Tools (default)
  12. - **Flexible Deployment** — use the hosted instance or self-host via npm, Docker (built from source), or source
  13. - **Streamable HTTP Transport** — compatible with Claude.ai, Claude Desktop, and MCP registries
  14. ## Quick Start
  15. ### Hosted Instance (Fastest)
  16. No installation required. Connect directly:
  17. ```
  18. https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp
  19. ```
  20. The hosted instance runs in Dynamic mode: it starts with 5 meta-tools that load toolsets on demand. Pass your FMP API key as `FMP_ACCESS_TOKEN` in the `?config=` session configuration (see [Usage](docs/USAGE.md#session-configuration)).
  21. ### Self-Hosted (One-Liner)
  22. ```bash
  23. npx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY
  24. ```
  25. Or install globally:
  26. ```bash
  27. npm install -g financial-modeling-prep-mcp-server
  28. fmp-mcp --fmp-token=YOUR_FMP_API_KEY
  29. ```
  30. > Get your API key at [financialmodelingprep.com](https://site.financialmodelingprep.com/).
  31. ## Table of Contents
  32. - [Installation](docs/INSTALLATION.md)
  33. - [Configuration](docs/CONFIGURATION.md)
  34. - [Usage](docs/USAGE.md)
  35. - [API Reference](docs/API_REFERENCE.md)
  36. - [Registries](docs/REGISTRIES.md)
  37. - [Contributing](CONTRIBUTING.md)
  38. - [License](LICENSE)
  39. ## Installation
  40. **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.
  41. Choose the method that fits your workflow:
  42. - **NPM** — `npm install -g financial-modeling-prep-mcp-server`
  43. - **Docker** — build the image from source (no pre-built image is published)
  44. - **Source** — clone and run with `npm install && npm run build`
  45. See [docs/INSTALLATION.md](docs/INSTALLATION.md) for detailed steps per method.
  46. ## Configuration
  47. The server supports three operational modes controlled via CLI arguments or environment variables:
  48. | Mode | How to Enable | Description |
  49. |------|---------------|-------------|
  50. | **Dynamic** | `DYNAMIC_TOOL_DISCOVERY=true` | Starts with 5 meta-tools; load toolsets at runtime |
  51. | **Static** | `FMP_TOOL_SETS=search,company` | Pre-loads specified toolsets on session creation |
  52. | **All Tools (default)** | *(default)* | Loads all 267 tools immediately |
  53. Precedence: for mode and tool sets, CLI args > Environment variables > Defaults. A session `?config=` token overrides the server's `FMP_ACCESS_TOKEN` for that session.
  54. See [docs/CONFIGURATION.md](docs/CONFIGURATION.md) for the full configuration reference.
  55. ## Usage
  56. Connect to the server over streamable HTTP:
  57. - **Claude.ai / Claude Desktop** — add as a remote connector (Settings > Connectors)
  58. - **Custom clients** — POST to `/mcp`: send `initialize` first, then the `mcp-session-id` it returns on every later request
  59. - **MCP registries** — see [Registries](#registries) for where this server is listed
  60. See [docs/USAGE.md](docs/USAGE.md) for client-specific setup, session headers, and request examples.
  61. ## Available Tools
  62. 24 toolsets covering:
  63. 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
  64. See [docs/API_REFERENCE.md](docs/API_REFERENCE.md) for the complete tool catalog.
  65. ## Registries
  66. This server is listed on multiple MCP registries for easy discovery:
  67. - [MCP Registry](https://registry.modelcontextprotocol.io/servers/io.github.imbenrabi/financial-modeling-prep-mcp-server)
  68. - [Glama.ai](https://glama.ai/mcp/servers/imbenrabi/Financial-Modeling-Prep-MCP-Server)
  69. - [LightNow](https://lightnow.ai/servers/io.github.imbenrabi/financial-modeling-prep-mcp-server)
  70. - [mcptry](https://mcptry.com/servers/io.github.imbenrabi/financial-modeling-prep-mcp-server)
  71. - [mcprush](https://mcprush.com/to/financial-modeling-prep-mcp?ref=badge)
  72. See [docs/REGISTRIES.md](docs/REGISTRIES.md) for the details of each listing.
  73. ## Contributing
  74. Contributions are welcome. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and pull request guidelines.
  75. ## License
  76. [Apache-2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

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