Aigroup Fmp
Financial Modeling Prep MCP server with tools, resources, prompts, and optional HTTP health/info endpoints for market data workflows.
Ask AI about Aigroup Fmp
Powered by Claude Β· Grounded in docs
I know everything about Aigroup Fmp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Financial Modeling Prep MCP Server
MCP server for Financial Modeling Prep (FMP) market data, built with the modern MCP SDK tool/resource/prompt model.
Overview
aigroup-fmp-mcp provides a structured MCP interface over the Financial Modeling Prep API for:
- real-time quotes and symbol lookup
- company profiles and financial statements
- analyst estimates and ratings
- technical indicators and historical charts
- earnings / economic calendar workflows
- reusable MCP resources and prompts for analysis tasks
Highlights
- 25 MCP tools covering market data, financials, analyst workflows, technical indicators, and calendar data
- Resources support for direct URI-based access patterns
- Prompt templates for stock analysis, portfolio review, and earnings preview
- Full stdio MCP support with optional HTTP health/info endpoints
- Zod validation for safer input handling
- Built on MCP SDK 1.27.1 with modern
McpServerAPIs
Quick Start
Requirements
- Node.js >= 18
- npm
- A valid FMP API key
Run with local source
git clone https://github.com/jackdark425/aigroup-fmp-mcp.git
cd aigroup-fmp-mcp
npm install
npm run build
export FMP_API_KEY="your-api-key"
npm start
HTTP mode
export FMP_API_KEY="your-api-key"
npm run start:http
By default, the HTTP server exposes:
POST /mcpβ returns501in this buildGET /healthβ health checkGET /β server info
HTTP mode in the current build is intended for health checks and service metadata only. Use stdio mode for MCP tools, resources, and prompts.
Configuration
Set your API key before starting the server:
export FMP_API_KEY="your-api-key"
Get your key from Financial Modeling Prep.
MCP Client Configuration
Claude Desktop / compatible MCP clients
{
"mcpServers": {
"fmp": {
"command": "node",
"args": ["/path/to/aigroup-fmp-mcp/build/index.js"],
"env": {
"FMP_API_KEY": "your-api-key"
}
}
}
}
Tools
Market Data
get_quotesearch_symbolget_market_gainersget_market_losersget_most_activeget_sector_performanceget_sp500_constituents
Financial Statements
get_company_profileget_income_statementget_balance_sheetget_cash_flowget_stock_newsget_key_metricsget_financial_ratios
Analyst Data
get_analyst_estimatesget_price_targetget_analyst_ratingsget_insider_tradingget_institutional_holders
Technical Indicators
get_technical_indicator_rsiget_technical_indicator_smaget_technical_indicator_emaget_historical_chart
Calendar Data
get_earnings_calendarget_economic_calendarget_economic_indicator
Resources
fmp://company/{symbol}/profilefmp://company/{symbol}/quotefmp://company/{symbol}/financials/{statement}/{period}fmp://market/overviewfmp://market/sectors/{date}
Prompts
stock_analysisportfolio_evaluationearnings_preview
Project Structure
aigroup-fmp-mcp/
βββ src/
β βββ index.ts
β βββ server.ts
β βββ tools/
β βββ resources/
β βββ prompts/
β βββ types/
β βββ utils/
βββ package.json
βββ tsconfig.json
βββ README.md
Development
npm install
npm run build
npm run dev
API Reference
All tools map to FMP endpoints. See the official docs:
Acknowledgments
Reference Project
- houtini-ai/fmp-mcp
- Repository: https://github.com/houtini-ai/fmp-mcp
- Reference scope: overall project direction, MCP server structure, and feature organization
Thanks to houtini-ai for the prior open-source work that helped inform this implementation.
License & Usage
This project is released under the MIT License.
You may use, copy, modify, merge, publish, distribute, sublicense, and sell copies of this software, including in commercial contexts, provided that the original copyright notice and license text are retained.
Please note:
- the software is provided "AS IS", without warranty of any kind
- you must preserve the relevant copyright and permission notice in copies or substantial portions of the software
- use of the FMP API remains subject to Financial Modeling Prep's own terms of service, quotas, billing rules, and data usage restrictions
See the full text in LICENSE.
