@houtini/fmp-mcp 1.0.0 → 1.0.2

package/README.md

@@ -7,11 +7,13 @@ Model Context Protocol (MCP) server providing access to Financial Modeling Prep'
 
 ## 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
+- **Real-time Market Data**: Live stock quotes with price, volume, and market metrics ✅ Free
+- **Company Information**: Detailed profiles including industry, sector, and key executives ✅ Free
+- **Financial Statements**: Income statements, balance sheets, and cash flow statements ✅ Free
+- **Symbol Search**: Find companies by name or ticker across global exchanges ✅ Free
+- **Stock News**: Latest news articles and market sentiment for specific symbols 💰 Paid Only
+
+> **Note**: Some features require a paid Financial Modeling Prep plan. The free tier provides access to fundamental data, quotes, and financial statements. News endpoints and certain advanced features require a paid subscription. See [API Limitations](#api-limitations) for details.
 
 ## Installation
 
@@ -105,7 +107,7 @@ Retrieve company cash flow statement data.
 
 **Returns:** Operating cash flow, investing activities, financing activities, and free cash flow.
 
-### `get_stock_news`
+### `get_stock_news` 💰 Paid Only
 Get latest news articles for a stock.
 
 **Parameters:**
@@ -114,6 +116,8 @@ Get latest news articles for a stock.
 
 **Returns:** News headlines, publication dates, URLs, and article summaries.
 
+**Note:** This endpoint requires a paid FMP plan. Free tier users will receive a 402 Payment Required error.
+
 ## Usage Examples
 
 Once installed, you can interact with the MCP server directly through Claude Desktop:
@@ -143,11 +147,34 @@ Get recent news about NVIDIA
 Financial Modeling Prep offers different pricing tiers:
 
 - **Free Tier**: 250 requests/day
-- **Starter**: 500 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.
 
+## API Limitations
+
+### Free Tier Access
+
+The following features are **included** in the free tier:
+- ✅ Real-time stock quotes (`get_quote`)
+- ✅ Company profiles (`get_company_profile`)
+- ✅ Financial statements - Income, Balance Sheet, Cash Flow (`get_income_statement`, `get_balance_sheet`, `get_cash_flow`)
+- ✅ Symbol search (`search_symbol`)
+
+### Paid Plan Required
+
+The following features require a **paid subscription**:
+- 💰 Stock news (`get_stock_news`) - Returns 402 Payment Required on free tier
+- 💰 Other premium endpoints (not yet implemented in this MCP)
+
+If you attempt to use a paid endpoint with a free API key, you'll receive:
+```
+Error: FMP API error: 402 Payment Required
+```
+
+To access these features, upgrade your plan at [FMP Pricing](https://site.financialmodelingprep.com/pricing-plans).
+
 ## Development
 
 ### Local Installation

package/build/index.js

@@ -259,7 +259,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case 'get_stock_news': {
                 const { symbol, limit = 10 } = args;
-                const data = await fetchFMP(`/stock_news?tickers=${symbol.toUpperCase()}&limit=${limit}`);
+                const data = await fetchFMP(`/news/stock?symbols=${symbol.toUpperCase()}&limit=${limit}`);
                 return {
                     content: [
                         {

package/commit_msg.txt

@@ -0,0 +1,8 @@
+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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houtini/fmp-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Model Context Protocol (MCP) server for Financial Modeling Prep API - stdio transport for Claude Desktop integration",
   "type": "module",
   "bin": {

package/src/index.ts

@@ -297,7 +297,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
       case 'get_stock_news': {
         const { symbol, limit = 10 } = args as { symbol: string; limit?: number };
-        const data = await fetchFMP(`/stock_news?tickers=${symbol.toUpperCase()}&limit=${limit}`);
+        const data = await fetchFMP(`/news/stock?symbols=${symbol.toUpperCase()}&limit=${limit}`);
         return {
           content: [
             {