{"id":28541423,"url":"https://github.com/imbenrabi/financial-modeling-prep-mcp-server","last_synced_at":"2026-05-02T13:05:01.659Z","repository":{"id":295209420,"uuid":"988409529","full_name":"imbenrabi/Financial-Modeling-Prep-MCP-Server","owner":"imbenrabi","description":"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.","archived":false,"fork":false,"pushed_at":"2026-01-29T16:53:15.000Z","size":1188,"stargazers_count":106,"open_issues_count":1,"forks_count":45,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-30T04:55:39.628Z","etag":null,"topics":["ai","etf-investments","financial-modeling-prep","fmp","llm","mcp","mcp-server","mcp-tools","smithery-ai","stock-data","stock-market"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imbenrabi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-22T14:01:13.000Z","updated_at":"2026-01-29T16:52:34.000Z","dependencies_parsed_at":"2025-05-24T08:30:09.398Z","dependency_job_id":"1e9ba071-4738-44ff-9e31-7c8bc9891df8","html_url":"https://github.com/imbenrabi/Financial-Modeling-Prep-MCP-Server","commit_stats":null,"previous_names":["imbenrabi/financial-modeling-prep-mcp-server"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/imbenrabi/Financial-Modeling-Prep-MCP-Server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imbenrabi%2FFinancial-Modeling-Prep-MCP-Server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imbenrabi%2FFinancial-Modeling-Prep-MCP-Server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imbenrabi%2FFinancial-Modeling-Prep-MCP-Server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imbenrabi%2FFinancial-Modeling-Prep-MCP-Server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imbenrabi","download_url":"https://codeload.github.com/imbenrabi/Financial-Modeling-Prep-MCP-Server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imbenrabi%2FFinancial-Modeling-Prep-MCP-Server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28937819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T08:53:31.997Z","status":"ssl_error","status_checked_at":"2026-01-31T08:51:38.521Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","etf-investments","financial-modeling-prep","fmp","llm","mcp","mcp-server","mcp-tools","smithery-ai","stock-data","stock-market"],"created_at":"2025-06-09T20:08:27.970Z","updated_at":"2026-05-02T13:05:01.652Z","avatar_url":"https://github.com/imbenrabi.png","language":"TypeScript","funding_links":[],"categories":["Finance \u0026 Fintech"],"sub_categories":["How to Submit"],"readme":"# Financial Modeling Prep MCP Server\n\n[![npm version](https://img.shields.io/npm/v/financial-modeling-prep-mcp-server.svg)](https://www.npmjs.com/package/financial-modeling-prep-mcp-server)\n[![license](https://img.shields.io/npm/l/financial-modeling-prep-mcp-server.svg)](LICENSE)\n\nA Model Context Protocol (MCP) server for the [Financial Modeling Prep](https://financialmodelingprep.com/) API, exposing 250+ financial data tools to AI assistants.\n\n## Features\n\n- **250+ Financial Tools** across 24 categories — stocks, ETFs, crypto, forex, commodities, economics, and more\n- **Dynamic Tool Management** — built on [toolception](https://www.npmjs.com/package/toolception) for runtime enable/disable of toolsets via meta-tools\n- **Three Server Modes** — Dynamic (meta-tools), Static (pre-loaded toolsets), or All Tools (default)\n- **Flexible Deployment** — use the hosted instance or self-host via npm, Docker, or source\n- **HTTP/SSE Transport** — compatible with Claude.ai, Claude Desktop, and MCP registries\n\n## Quick Start\n\n### Hosted Instance (Fastest)\n\nNo installation required. Connect directly:\n\n```\nhttps://financial-modeling-prep-mcp-server-production.up.railway.app/mcp\n```\n\nProvide your `FMP_ACCESS_TOKEN` in session configuration and start using 5 meta-tools to load toolsets on demand.\n\n### Self-Hosted (One-Liner)\n\n```bash\nnpx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY\n```\n\nOr install globally:\n\n```bash\nnpm install -g financial-modeling-prep-mcp-server\nfmp-mcp --fmp-token=YOUR_FMP_API_KEY\n```\n\n\u003e Get your API key at [financialmodelingprep.com](https://site.financialmodelingprep.com/).\n\n## Table of Contents\n\n- [Installation](docs/INSTALLATION.md)\n- [Configuration](docs/CONFIGURATION.md)\n- [Usage](docs/USAGE.md)\n- [API Reference](docs/API_REFERENCE.md)\n- [Registries](docs/REGISTRIES.md)\n- [Contributing](CONTRIBUTING.md)\n- [License](LICENSE)\n\n## Installation\n\n**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.\n\nChoose the method that fits your workflow:\n\n- **NPM** — `npm install -g financial-modeling-prep-mcp-server`\n- **Docker** — build from source or pull a pre-built image\n- **Source** — clone and run with `npm install \u0026\u0026 npm run build`\n\nSee [docs/INSTALLATION.md](docs/INSTALLATION.md) for detailed steps per method.\n\n## Configuration\n\nThe server supports three operational modes controlled via CLI arguments, environment variables, or session configuration:\n\n| Mode | How to Enable | Description |\n|------|---------------|-------------|\n| **Dynamic** | `DYNAMIC_TOOL_DISCOVERY=true` | Starts with 5 meta-tools; load toolsets at runtime |\n| **Static** | `FMP_TOOL_SETS=search,company` | Pre-loads specified toolsets on session creation |\n| **All Tools (default)** | *(default)* | Loads all 250+ tools immediately |\n\nPrecedence: CLI args \u003e Environment variables \u003e Session config \u003e Defaults.\n\nSee [docs/CONFIGURATION.md](docs/CONFIGURATION.md) for the full configuration reference.\n\n## Usage\n\nConnect to the server via HTTP/SSE transport:\n\n- **Claude.ai / Claude Desktop** — add as a remote connector (Settings \u003e Connectors)\n- **Custom clients** — POST to `/mcp` with `mcp-client-id` header\n- **MCP registries** — Smithery.ai, Glama.ai, and others\n\nSee [docs/USAGE.md](docs/USAGE.md) for client-specific setup, session headers, and request examples.\n\n## Available Tools\n\n24 categories covering:\n\nSearch · Directory \u0026 Symbol Lists · Company Information · Financial Statements · Financial Metrics \u0026 Analysis · Technical Indicators · Quotes \u0026 Price Data · Market Indexes \u0026 Performance · Market Data · News \u0026 Press Releases · SEC Filings · Insider \u0026 Institutional Trading · ETFs \u0026 Funds · Government Trading · Cryptocurrency \u0026 Forex · Earnings · Special Data Sets · Commodities · Economics · Bulk Data Tools\n\nSee [docs/API_REFERENCE.md](docs/API_REFERENCE.md) for the complete tool catalog.\n\n## Registries\n\nThis server is listed on multiple MCP registries for easy discovery:\n\n- [Smithery.ai](https://smithery.ai/server/@imbenrabi/financial-modeling-prep-mcp-server)\n- [Glama.ai](https://glama.ai/mcp/servers/@imbenrabi/financial-modeling-prep-mcp-server)\n\nSee [docs/REGISTRIES.md](docs/REGISTRIES.md) for registry-specific setup instructions.\n\n## Contributing\n\nContributions are welcome. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and pull request guidelines.\n\n## License\n\n[Apache-2.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimbenrabi%2Ffinancial-modeling-prep-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimbenrabi%2Ffinancial-modeling-prep-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimbenrabi%2Ffinancial-modeling-prep-mcp-server/lists"}