finmap-mcp 1.0.5 → 1.0.7

package/README.md

@@ -1,25 +1,18 @@
 # Finmap MCP Server
 
-A Model Context Protocol (MCP) server that provides comprehensive financial market data from [finmap.org](https://finmap.org). Access historical market data for multiple global stock exchanges through a standardized MCP interface.
-
-## Features
-
-- **Comprehensive Data**: Market capitalization, trading volume, price changes, sector analysis
-- **Interactive Charts**: Direct links to finmap.org visualizations
-- **Both Remote & Local**: Cloudflare Workers hosted server + npm package
-- **Rich Metadata**: Company information, sector classifications, historical data
+The finmap.org MCP server provides comprehensive historical data from the US, UK, Russian and Turkish stock exchanges. Access sectors, tickers, company profiles, market cap, volume, value, and trade counts, as well as treemap and histogram visualizations.
 
 ## Supported Exchanges
 
-| Exchange | Code | Country | Earliest Data |
-|----------|------|---------|---------------|
-| Moscow Exchange | `moex` | Russia | 2011-12-19 |
-| New York Stock Exchange | `nyse` | USA | 2024-12-09 |
-| NASDAQ | `nasdaq` | USA | 2024-12-09 |
-| American Stock Exchange | `amex` | USA | 2024-12-09 |
-| All US Markets | `us-all` | USA | 2024-12-09 |
-| London Stock Exchange | `lse` | UK | 2025-02-07 |
-| Borsa Istanbul | `bist` | Turkey | 2015-11-30 |
+| Exchange | Code | Country | Earliest Data | Update Frequency |
+|----------|------|---------|---------------|------------------|
+| Moscow Exchange | `moex` | Russia | 2011-12-19 | Every 15 minutes (weekdays) |
+| New York Stock Exchange | `nyse` | United States | 2024-12-09 | Hourly (weekdays) |
+| NASDAQ Stock Market | `nasdaq` | United States | 2024-12-09 | Hourly (weekdays) |
+| American Stock Exchange | `amex` | United States | 2024-12-09 | Hourly (weekdays) |
+| US Combined (AMEX + NASDAQ + NYSE) | `us-all` | United States | 2024-12-09 | Hourly (weekdays) |
+| London Stock Exchange | `lse` | United Kingdom | 2025-02-07 | Hourly (weekdays) |
+| Borsa Istanbul | `bist` | Turkey | 2015-11-30 | Bi-monthly |
 
 ## Installation & Usage
 
@@ -219,6 +212,7 @@ Get detailed company information including business description (US market only)
 
 ```json
 {
+  {
     "ModuleTitle": {
       "label": "Module Title",
       "value": "Company Description"

package/dist/core.js

@@ -46,14 +46,49 @@ const EXCHANGE_TO_COUNTRY_MAP = {
     moex: "russia",
     bist: "turkey",
 };
-const MIN_AVAILABLE_DATES = {
-    amex: "2024-12-09",
-    nasdaq: "2024-12-09",
-    nyse: "2024-12-09",
-    "us-all": "2024-12-09",
-    lse: "2025-02-07",
-    moex: "2011-12-19",
-    bist: "2015-11-30",
+const EXCHANGE_INFO = {
+    amex: {
+        name: "American Stock Exchange",
+        country: "United States",
+        availableSince: "2024-12-09",
+        updateFrequency: "Hourly (weekdays)",
+    },
+    nasdaq: {
+        name: "NASDAQ Stock Market",
+        country: "United States",
+        availableSince: "2024-12-09",
+        updateFrequency: "Hourly (weekdays)",
+    },
+    nyse: {
+        name: "New York Stock Exchange",
+        country: "United States",
+        availableSince: "2024-12-09",
+        updateFrequency: "Hourly (weekdays)",
+    },
+    "us-all": {
+        name: "US Combined (AMEX + NASDAQ + NYSE)",
+        country: "United States",
+        availableSince: "2024-12-09",
+        updateFrequency: "Hourly (weekdays)",
+    },
+    lse: {
+        name: "London Stock Exchange",
+        country: "United Kingdom",
+        availableSince: "2025-02-07",
+        updateFrequency: "Hourly (weekdays)",
+    },
+    moex: {
+        name: "Moscow Exchange",
+        country: "Russia",
+        availableSince: "2011-12-19",
+        updateFrequency: "Every 15 minutes (weekdays)",
+    },
+    bist: {
+        name: "Borsa Istanbul",
+        country: "Turkey",
+        availableSince: "2015-11-30",
+        updateFrequency: "Bi-monthly",
+    },
 };
 const commonInputSchema = {
     stockExchange: z
@@ -92,7 +127,7 @@ async function fetchMarketData(stockExchange, formattedDate) {
     const url = `${DATA_BASE_URL}/data-${country}/refs/heads/main/marketdata/${date}/${stockExchange}.json`;
     const response = await fetch(url);
     if (response.status === 404) {
-        throw new Error(`Not found, try another date. The date must be on or after ${MIN_AVAILABLE_DATES[stockExchange]} for ${stockExchange}`);
+        throw new Error(`Not found, try another date. The date must be on or after ${EXCHANGE_INFO[stockExchange].availableSince} for ${stockExchange}`);
     }
     return response.json();
 }
@@ -107,16 +142,16 @@ async function fetchSecurityInfo(exchange, ticker) {
     return data;
 }
 export function registerFinmapTools(server) {
-    server.registerResource("minimum-dates", "finmap://minimum-dates", {
-        title: "Minimum date for stock exchange",
-        description: "Earliest available dates for each exchange",
+    server.registerResource("exchanges-info", "finmap://exchanges-info", {
+        title: "Stock exchanges information",
+        description: "Available stock exchanges with details about data availability and update frequency",
         mimeType: "application/json",
     }, async () => {
         return {
             contents: [
                 {
-                    uri: "finmap://minimum-dates",
-                    text: JSON.stringify(MIN_AVAILABLE_DATES, null, 2),
+                    uri: "finmap://exchanges-info",
+                    text: JSON.stringify(EXCHANGE_INFO, null, 2),
                 },
             ],
         };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "finmap-mcp",
-	"version": "1.0.5",
+	"version": "1.0.7",
 	"description": "MCP server providing financial market data from finmap.org",
 	"main": "./dist/stdio-server.js",
 	"type": "module",