@houtini/fmp-mcp 1.0.0

package/README.md

@@ -0,0 +1,240 @@
+# Financial Modeling Prep MCP Server
+
+Model Context Protocol (MCP) server providing access to Financial Modeling Prep's comprehensive financial data API. Get real-time stock quotes, company fundamentals, financial statements, and market news directly in Claude Desktop.
+
+[![npm version](https://badge.fury.io/js/@houtini%2Ffmp-mcp.svg)](https://badge.fury.io/js/@houtini%2Ffmp-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **Real-time Market Data**: Live stock quotes with price, volume, and market metrics
+- **Company Information**: Detailed profiles including industry, sector, and key executives
+- **Financial Statements**: Income statements, balance sheets, and cash flow statements
+- **Symbol Search**: Find companies by name or ticker across global exchanges
+- **Stock News**: Latest news articles and market sentiment for specific symbols
+
+## Installation
+
+### Prerequisites
+
+- [Claude Desktop](https://claude.ai/download)
+- Node.js 18 or higher
+- Financial Modeling Prep API key ([Get one here](https://financialmodelingprep.com/developer/docs))
+
+### Quick Start with NPX
+
+Add to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "financial-modeling-prep": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@houtini/fmp-mcp"
+      ],
+      "env": {
+        "FMP_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+Replace `your_api_key_here` with your actual API key from Financial Modeling Prep.
+
+**Important**: Restart Claude Desktop completely after updating the configuration.
+
+## Available Tools
+
+### `get_quote`
+Get real-time stock quote data.
+
+**Parameters:**
+- `symbol` (required): Stock ticker symbol (e.g., AAPL, TSLA, MSFT)
+
+**Returns:** Current price, volume, market cap, P/E ratio, day high/low, and more.
+
+### `search_symbol`
+Search for stock symbols by company name or ticker.
+
+**Parameters:**
+- `query` (required): Search query (company name or partial ticker)
+
+**Returns:** Matching symbols with company names and exchange information.
+
+### `get_company_profile`
+Get detailed company profile and fundamental data.
+
+**Parameters:**
+- `symbol` (required): Stock ticker symbol
+
+**Returns:** Company description, industry, sector, CEO, employee count, headquarters, website, and key financial metrics.
+
+### `get_income_statement`
+Retrieve company income statement data.
+
+**Parameters:**
+- `symbol` (required): Stock ticker symbol
+- `period` (optional): "annual" or "quarter" (default: "annual")
+- `limit` (optional): Number of periods to return (default: 5)
+
+**Returns:** Revenue, expenses, net income, EPS, and other profitability metrics.
+
+### `get_balance_sheet`
+Retrieve company balance sheet data.
+
+**Parameters:**
+- `symbol` (required): Stock ticker symbol
+- `period` (optional): "annual" or "quarter" (default: "annual")
+- `limit` (optional): Number of periods to return (default: 5)
+
+**Returns:** Assets, liabilities, shareholder equity, and detailed line items.
+
+### `get_cash_flow`
+Retrieve company cash flow statement data.
+
+**Parameters:**
+- `symbol` (required): Stock ticker symbol
+- `period` (optional): "annual" or "quarter" (default: "annual")
+- `limit` (optional): Number of periods to return (default: 5)
+
+**Returns:** Operating cash flow, investing activities, financing activities, and free cash flow.
+
+### `get_stock_news`
+Get latest news articles for a stock.
+
+**Parameters:**
+- `symbol` (required): Stock ticker symbol
+- `limit` (optional): Number of articles to return (default: 10)
+
+**Returns:** News headlines, publication dates, URLs, and article summaries.
+
+## Usage Examples
+
+Once installed, you can interact with the MCP server directly through Claude Desktop:
+
+```
+Get a quote for Apple stock
+```
+
+```
+Show me Tesla's quarterly income statements for the last 8 quarters
+```
+
+```
+Compare the P/E ratios of Microsoft and Google
+```
+
+```
+Search for semiconductor companies
+```
+
+```
+Get recent news about NVIDIA
+```
+
+## API Rate Limits
+
+Financial Modeling Prep offers different pricing tiers:
+
+- **Free Tier**: 250 requests/day
+- **Starter**: 500 requests/day
+- **Professional**: 1,000+ requests/day
+
+See [FMP Pricing](https://financialmodelingprep.com/developer/docs/pricing) for current plans and limits.
+
+## Development
+
+### Local Installation
+
+```bash
+git clone https://github.com/yourusername/fmp-mcp.git
+cd fmp-mcp
+npm install
+npm run build
+```
+
+### Claude Desktop Configuration for Local Development
+
+```json
+{
+  "mcpServers": {
+    "financial-modeling-prep": {
+      "command": "node",
+      "args": [
+        "C:\\path\\to\\fmp-mcp\\build\\index.js"
+      ],
+      "env": {
+        "FMP_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Building
+
+```bash
+npm run build
+```
+
+Output goes to the `build/` directory.
+
+## API Coverage
+
+This MCP server implements 7 core endpoints from the Financial Modeling Prep API:
+
+- Stock Quote
+- Symbol Search
+- Company Profile
+- Income Statement
+- Balance Sheet
+- Cash Flow Statement
+- Stock News
+
+For the complete API reference, see the [FMP Developer Documentation](https://site.financialmodelingprep.com/developer/docs).
+
+## Troubleshooting
+
+### MCP Server Not Appearing in Claude Desktop
+
+1. Verify your `claude_desktop_config.json` syntax is valid JSON
+2. Check that the `FMP_API_KEY` environment variable is set
+3. Restart Claude Desktop completely (quit from system tray/menu bar)
+4. Check Claude Desktop logs for error messages
+
+### API Authentication Errors
+
+If you see `403 Forbidden` errors:
+- Verify your API key is correct
+- Check you haven't exceeded your rate limit
+- Ensure your API key has the required permissions
+
+### Tool Execution Failures
+
+- Verify the stock symbol exists (use `search_symbol` first)
+- Check your internet connection
+- Verify FMP API is operational at [status.financialmodelingprep.com](https://financialmodelingprep.com)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Resources
+
+- [Financial Modeling Prep API](https://financialmodelingprep.com)
+- [MCP Documentation](https://modelcontextprotocol.io)
+- [Claude Desktop](https://claude.ai/download)
+
+## Acknowledgments
+
+Built with the [Model Context Protocol SDK](https://github.com/modelcontextprotocol/sdk) by Anthropic.

package/build/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Financial Modeling Prep MCP Server
+ *
+ * Stdio-based Model Context Protocol server for Financial Modeling Prep API.
+ * Provides real-time financial data, stock quotes, company fundamentals, and market insights.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/build/index.js

@@ -0,0 +1,302 @@
+#!/usr/bin/env node
+/**
+ * Financial Modeling Prep MCP Server
+ *
+ * Stdio-based Model Context Protocol server for Financial Modeling Prep API.
+ * Provides real-time financial data, stock quotes, company fundamentals, and market insights.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+const FMP_API_KEY = process.env.FMP_API_KEY;
+const FMP_BASE_URL = 'https://financialmodelingprep.com/stable';
+if (!FMP_API_KEY) {
+    console.error('Error: FMP_API_KEY environment variable is required');
+    process.exit(1);
+}
+/**
+ * Helper function to make FMP API requests
+ */
+async function fetchFMP(endpoint) {
+    const url = `${FMP_BASE_URL}${endpoint}${endpoint.includes('?') ? '&' : '?'}apikey=${FMP_API_KEY}`;
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`FMP API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+}
+/**
+ * Define available tools
+ */
+const TOOLS = [
+    {
+        name: 'get_quote',
+        description: 'Get real-time stock quote for a symbol (e.g., AAPL, TSLA, MSFT)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                symbol: {
+                    type: 'string',
+                    description: 'Stock ticker symbol (e.g., AAPL)',
+                },
+            },
+            required: ['symbol'],
+        },
+    },
+    {
+        name: 'search_symbol',
+        description: 'Search for stock symbols by company name or ticker',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query (company name or ticker)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'get_company_profile',
+        description: 'Get detailed company profile information including description, industry, sector, CEO, and more',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                symbol: {
+                    type: 'string',
+                    description: 'Stock ticker symbol',
+                },
+            },
+            required: ['symbol'],
+        },
+    },
+    {
+        name: 'get_income_statement',
+        description: 'Get company income statement (annual or quarterly)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                symbol: {
+                    type: 'string',
+                    description: 'Stock ticker symbol',
+                },
+                period: {
+                    type: 'string',
+                    description: 'Period type (annual or quarter)',
+                    enum: ['annual', 'quarter'],
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Number of periods to return (default: 5)',
+                },
+            },
+            required: ['symbol'],
+        },
+    },
+    {
+        name: 'get_balance_sheet',
+        description: 'Get company balance sheet statement (annual or quarterly)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                symbol: {
+                    type: 'string',
+                    description: 'Stock ticker symbol',
+                },
+                period: {
+                    type: 'string',
+                    description: 'Period type (annual or quarter)',
+                    enum: ['annual', 'quarter'],
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Number of periods to return (default: 5)',
+                },
+            },
+            required: ['symbol'],
+        },
+    },
+    {
+        name: 'get_cash_flow',
+        description: 'Get company cash flow statement (annual or quarterly)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                symbol: {
+                    type: 'string',
+                    description: 'Stock ticker symbol',
+                },
+                period: {
+                    type: 'string',
+                    description: 'Period type (annual or quarter)',
+                    enum: ['annual', 'quarter'],
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Number of periods to return (default: 5)',
+                },
+            },
+            required: ['symbol'],
+        },
+    },
+    {
+        name: 'get_stock_news',
+        description: 'Get latest news articles for a stock symbol',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                symbol: {
+                    type: 'string',
+                    description: 'Stock ticker symbol',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Number of articles to return (default: 10)',
+                },
+            },
+            required: ['symbol'],
+        },
+    },
+];
+/**
+ * Create and configure the MCP server
+ */
+const server = new Server({
+    name: 'fmp-mcp-server',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+/**
+ * Handler for listing available tools
+ */
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: TOOLS,
+    };
+});
+/**
+ * Handler for tool execution
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'get_quote': {
+                const { symbol } = args;
+                const data = await fetchFMP(`/quote?symbol=${symbol.toUpperCase()}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'search_symbol': {
+                const { query } = args;
+                const data = await fetchFMP(`/search-symbol?query=${encodeURIComponent(query)}&limit=10`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_company_profile': {
+                const { symbol } = args;
+                const data = await fetchFMP(`/profile?symbol=${symbol.toUpperCase()}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_income_statement': {
+                const { symbol, period = 'annual', limit = 5 } = args;
+                const data = await fetchFMP(`/income-statement?symbol=${symbol.toUpperCase()}&period=${period}&limit=${limit}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_balance_sheet': {
+                const { symbol, period = 'annual', limit = 5 } = args;
+                const data = await fetchFMP(`/balance-sheet-statement?symbol=${symbol.toUpperCase()}&period=${period}&limit=${limit}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_cash_flow': {
+                const { symbol, period = 'annual', limit = 5 } = args;
+                const data = await fetchFMP(`/cash-flow-statement?symbol=${symbol.toUpperCase()}&period=${period}&limit=${limit}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_stock_news': {
+                const { symbol, limit = 10 } = args;
+                const data = await fetchFMP(`/stock_news?tickers=${symbol.toUpperCase()}&limit=${limit}`);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+/**
+ * Start the server
+ */
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr so it doesn't interfere with stdio protocol
+    console.error('FMP MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@houtini/fmp-mcp",
+  "version": "1.0.0",
+  "description": "Model Context Protocol (MCP) server for Financial Modeling Prep API - stdio transport for Claude Desktop integration",
+  "type": "module",
+  "bin": {
+    "fmp-mcp": "./build/index.js"
+  },
+  "main": "./build/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "financial-modeling-prep",
+    "fmp",
+    "stock-market",
+    "financial-data",
+    "model-context-protocol",
+    "claude",
+    "ai-tools"
+  ],
+  "author": "Houtini AI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/houtini-ai/fmp-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.3",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}