@houtini/fmp-mcp 1.0.2 → 1.1.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@houtini/fmp-mcp",
-  "version": "1.0.2",
-  "description": "Model Context Protocol (MCP) server for Financial Modeling Prep API - stdio transport for Claude Desktop integration",
+  "version": "1.1.1",
+  "description": "Model Context Protocol (MCP) server for Financial Modeling Prep API - comprehensive financial data including quotes, fundamentals, analyst data, technical indicators, and market insights",
   "type": "module",
   "bin": {
     "fmp-mcp": "./build/index.js"
@@ -19,7 +19,12 @@
     "financial-data",
     "model-context-protocol",
     "claude",
-    "ai-tools"
+    "ai-tools",
+    "analyst-data",
+    "technical-indicators",
+    "market-data",
+    "insider-trading",
+    "economic-data"
   ],
   "author": "Houtini AI",
   "license": "MIT",

package/src/index.ts

@@ -171,6 +171,336 @@ const TOOLS: Tool[] = [
       required: ['symbol'],
     },
   },
+  {
+    name: 'get_market_gainers',
+    description: 'Get stocks with the largest price increases (top gainers)',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+  {
+    name: 'get_market_losers',
+    description: 'Get stocks with the largest price drops (top losers)',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+  {
+    name: 'get_most_active',
+    description: 'Get most actively traded stocks by volume',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+  {
+    name: 'get_sector_performance',
+    description: 'Get current sector performance snapshot',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        date: {
+          type: 'string',
+          description: 'Date in YYYY-MM-DD format (optional, defaults to latest)',
+        },
+      },
+    },
+  },
+  {
+    name: 'get_analyst_estimates',
+    description: 'Get analyst financial estimates for a stock (revenue, EPS forecasts)',
+    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: 10)',
+        },
+      },
+      required: ['symbol'],
+    },
+  },
+  {
+    name: 'get_price_target',
+    description: 'Get analyst price target summary for a stock',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: {
+          type: 'string',
+          description: 'Stock ticker symbol',
+        },
+      },
+      required: ['symbol'],
+    },
+  },
+  {
+    name: 'get_analyst_ratings',
+    description: 'Get analyst ratings and upgrades/downgrades for a stock',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: {
+          type: 'string',
+          description: 'Stock ticker symbol',
+        },
+      },
+      required: ['symbol'],
+    },
+  },
+  {
+    name: 'get_insider_trading',
+    description: 'Get recent insider trading activity for a stock',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: {
+          type: 'string',
+          description: 'Stock ticker symbol',
+        },
+        limit: {
+          type: 'number',
+          description: 'Number of transactions to return (default: 100)',
+        },
+      },
+      required: ['symbol'],
+    },
+  },
+  {
+    name: 'get_key_metrics',
+    description: 'Get key financial metrics (P/E, ROE, debt ratios, etc.)',
+    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_financial_ratios',
+    description: 'Get detailed financial ratios (profitability, liquidity, efficiency)',
+    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_earnings_calendar',
+    description: 'Get upcoming earnings announcements calendar',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        from: {
+          type: 'string',
+          description: 'Start date in YYYY-MM-DD format (optional)',
+        },
+        to: {
+          type: 'string',
+          description: 'End date in YYYY-MM-DD format (optional)',
+        },
+      },
+    },
+  },
+  {
+    name: 'get_economic_calendar',
+    description: 'Get upcoming economic data releases calendar',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        from: {
+          type: 'string',
+          description: 'Start date in YYYY-MM-DD format (optional)',
+        },
+        to: {
+          type: 'string',
+          description: 'End date in YYYY-MM-DD format (optional)',
+        },
+      },
+    },
+  },
+  {
+    name: 'get_economic_indicator',
+    description: 'Get economic indicator data (GDP, unemployment, inflation, etc.)',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: {
+          type: 'string',
+          description: 'Indicator name (e.g., GDP, unemploymentRate, CPI)',
+        },
+        from: {
+          type: 'string',
+          description: 'Start date in YYYY-MM-DD format (optional)',
+        },
+        to: {
+          type: 'string',
+          description: 'End date in YYYY-MM-DD format (optional)',
+        },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'get_technical_indicator_rsi',
+    description: 'Get Relative Strength Index (RSI) technical indicator',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: {
+          type: 'string',
+          description: 'Stock ticker symbol',
+        },
+        timeframe: {
+          type: 'string',
+          description: 'Timeframe (1min, 5min, 15min, 30min, 1hour, 4hour, 1day)',
+          enum: ['1min', '5min', '15min', '30min', '1hour', '4hour', '1day'],
+        },
+        period: {
+          type: 'number',
+          description: 'Period length (default: 14)',
+        },
+      },
+      required: ['symbol', 'timeframe'],
+    },
+  },
+  {
+    name: 'get_technical_indicator_sma',
+    description: 'Get Simple Moving Average (SMA) technical indicator',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: {
+          type: 'string',
+          description: 'Stock ticker symbol',
+        },
+        timeframe: {
+          type: 'string',
+          description: 'Timeframe (1min, 5min, 15min, 30min, 1hour, 4hour, 1day)',
+          enum: ['1min', '5min', '15min', '30min', '1hour', '4hour', '1day'],
+        },
+        period: {
+          type: 'number',
+          description: 'Period length (default: 10)',
+        },
+      },
+      required: ['symbol', 'timeframe'],
+    },
+  },
+  {
+    name: 'get_technical_indicator_ema',
+    description: 'Get Exponential Moving Average (EMA) technical indicator',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: {
+          type: 'string',
+          description: 'Stock ticker symbol',
+        },
+        timeframe: {
+          type: 'string',
+          description: 'Timeframe (1min, 5min, 15min, 30min, 1hour, 4hour, 1day)',
+          enum: ['1min', '5min', '15min', '30min', '1hour', '4hour', '1day'],
+        },
+        period: {
+          type: 'number',
+          description: 'Period length (default: 10)',
+        },
+      },
+      required: ['symbol', 'timeframe'],
+    },
+  },
+  {
+    name: 'get_historical_chart',
+    description: 'Get historical price data with flexible time intervals',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: {
+          type: 'string',
+          description: 'Stock ticker symbol',
+        },
+        interval: {
+          type: 'string',
+          description: 'Time interval (1min, 5min, 15min, 30min, 1hour, 4hour)',
+          enum: ['1min', '5min', '15min', '30min', '1hour', '4hour'],
+        },
+        from: {
+          type: 'string',
+          description: 'Start date in YYYY-MM-DD format (optional)',
+        },
+        to: {
+          type: 'string',
+          description: 'End date in YYYY-MM-DD format (optional)',
+        },
+      },
+      required: ['symbol', 'interval'],
+    },
+  },
+  {
+    name: 'get_institutional_holders',
+    description: 'Get institutional ownership (13F filings) for a stock',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        symbol: {
+          type: 'string',
+          description: 'Stock ticker symbol',
+        },
+        limit: {
+          type: 'number',
+          description: 'Number of holders to return (default: 100)',
+        },
+      },
+      required: ['symbol'],
+    },
+  },
+  {
+    name: 'get_sp500_constituents',
+    description: 'Get list of S&P 500 index constituents',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
 ];
 
 /**
@@ -179,7 +509,7 @@ const TOOLS: Tool[] = [
 const server = new Server(
   {
     name: 'fmp-mcp-server',
-    version: '1.0.0',
+    version: '1.1.0',
   },
   {
     capabilities: {
@@ -308,6 +638,297 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      case 'get_market_gainers': {
+        const data = await fetchFMP('/biggest-gainers');
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_market_losers': {
+        const data = await fetchFMP('/biggest-losers');
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_most_active': {
+        const data = await fetchFMP('/most-actives');
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_sector_performance': {
+        const { date } = args as { date?: string };
+        const endpoint = date 
+          ? `/sector-performance-snapshot?date=${date}`
+          : '/sector-performance-snapshot?date=' + new Date().toISOString().split('T')[0];
+        const data = await fetchFMP(endpoint);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_analyst_estimates': {
+        const { symbol, period = 'annual', limit = 10 } = args as { 
+          symbol: string; 
+          period?: string; 
+          limit?: number;
+        };
+        const data = await fetchFMP(`/analyst-estimates?symbol=${symbol.toUpperCase()}&period=${period}&limit=${limit}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_price_target': {
+        const { symbol } = args as { symbol: string };
+        const data = await fetchFMP(`/price-target-summary?symbol=${symbol.toUpperCase()}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_analyst_ratings': {
+        const { symbol } = args as { symbol: string };
+        const data = await fetchFMP(`/grades?symbol=${symbol.toUpperCase()}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_insider_trading': {
+        const { symbol, limit = 100 } = args as { symbol: string; limit?: number };
+        const data = await fetchFMP(`/insider-trading/search?symbol=${symbol.toUpperCase()}&limit=${limit}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_key_metrics': {
+        const { symbol, period = 'annual', limit = 5 } = args as { 
+          symbol: string; 
+          period?: string; 
+          limit?: number;
+        };
+        const data = await fetchFMP(`/key-metrics?symbol=${symbol.toUpperCase()}&period=${period}&limit=${limit}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_financial_ratios': {
+        const { symbol, period = 'annual', limit = 5 } = args as { 
+          symbol: string; 
+          period?: string; 
+          limit?: number;
+        };
+        const data = await fetchFMP(`/ratios?symbol=${symbol.toUpperCase()}&period=${period}&limit=${limit}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_earnings_calendar': {
+        const { from, to } = args as { from?: string; to?: string };
+        let endpoint = '/earnings-calendar';
+        const params = [];
+        if (from) params.push(`from=${from}`);
+        if (to) params.push(`to=${to}`);
+        if (params.length > 0) endpoint += `?${params.join('&')}`;
+        const data = await fetchFMP(endpoint);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_economic_calendar': {
+        const { from, to } = args as { from?: string; to?: string };
+        let endpoint = '/economic-calendar';
+        const params = [];
+        if (from) params.push(`from=${from}`);
+        if (to) params.push(`to=${to}`);
+        if (params.length > 0) endpoint += `?${params.join('&')}`;
+        const data = await fetchFMP(endpoint);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_economic_indicator': {
+        const { name, from, to } = args as { name: string; from?: string; to?: string };
+        let endpoint = `/economic-indicators?name=${name}`;
+        if (from) endpoint += `&from=${from}`;
+        if (to) endpoint += `&to=${to}`;
+        const data = await fetchFMP(endpoint);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_technical_indicator_rsi': {
+        const { symbol, timeframe, period = 14 } = args as { 
+          symbol: string; 
+          timeframe: string; 
+          period?: number;
+        };
+        const data = await fetchFMP(`/technical-indicators/rsi?symbol=${symbol.toUpperCase()}&timeframe=${timeframe}&periodLength=${period}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_technical_indicator_sma': {
+        const { symbol, timeframe, period = 10 } = args as { 
+          symbol: string; 
+          timeframe: string; 
+          period?: number;
+        };
+        const data = await fetchFMP(`/technical-indicators/sma?symbol=${symbol.toUpperCase()}&timeframe=${timeframe}&periodLength=${period}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_technical_indicator_ema': {
+        const { symbol, timeframe, period = 10 } = args as { 
+          symbol: string; 
+          timeframe: string; 
+          period?: number;
+        };
+        const data = await fetchFMP(`/technical-indicators/ema?symbol=${symbol.toUpperCase()}&timeframe=${timeframe}&periodLength=${period}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_historical_chart': {
+        const { symbol, interval, from, to } = args as { 
+          symbol: string; 
+          interval: string; 
+          from?: string; 
+          to?: string;
+        };
+        let endpoint = `/historical-chart/${interval}?symbol=${symbol.toUpperCase()}`;
+        if (from) endpoint += `&from=${from}`;
+        if (to) endpoint += `&to=${to}`;
+        const data = await fetchFMP(endpoint);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_institutional_holders': {
+        const { symbol, limit = 100 } = args as { symbol: string; limit?: number };
+        const data = await fetchFMP(`/institutional-ownership/latest?symbol=${symbol.toUpperCase()}&limit=${limit}`);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_sp500_constituents': {
+        const data = await fetchFMP('/sp500-constituent');
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(data, null, 2),
+            },
+          ],
+        };
+      }
+
       default:
         throw new Error(`Unknown tool: ${name}`);
     }
@@ -332,7 +953,6 @@ 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');
 }
 

package/commit_msg.txt

@@ -1,8 +0,0 @@
-fix: correct stock news endpoint and document paid tier requirements
-
-- Fix stock news endpoint from /stock_news?tickers= to /news/stock?symbols=
-- Update README with clear free vs paid tier indicators
-- Add API Limitations section explaining 402 Payment Required errors
-- Bump version to 1.0.2
-
-Resolves 404 errors on get_stock_news tool (now correctly returns 402 for free tier)