Skip to main content
Glama
Finmap MCP Server

Finmap MCP Server

Finmap MCP Server

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.

基于原项目: 此项目基于 Finmap MCP Server 修改而来

Supported Exchanges

Exchange

Code

Country

Earliest Data

Update Frequency

New York Stock Exchange

nyse

United States

2024-12-09

Daily

NASDAQ Stock Market

nasdaq

United States

2024-12-09

Daily

American Stock Exchange

amex

United States

2024-12-09

Daily

US Combined (AMEX + NASDAQ + NYSE)

us-all

United States

2024-12-09

Daily

London Stock Exchange

lse

United Kingdom

2025-02-07

Hourly (weekdays)

Hong Kong Stock Exchange

hkex

Hong Kong

2025-09-26

Every 30 minutes (weekdays)

Borsa Istanbul

bist

Turkey

2015-11-30

Every two months

Moscow Exchange

moex

Russia

2011-12-19

Every 15 minutes (weekdays)

Related MCP server: Stock Data MCP Server

Installation & Usage

Option 1: Remote Server (Hosted)

Connect to our hosted MCP server without any installation:

Server URL: https://mcp.finmap.org

Claude Desktop Configuration:

{
  "mcpServers": {
    "finmap": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.finmap.org"]
    }
  }
}

Option 2: Local Package (npm)

Install and run locally for better performance and offline access:

# Install globally
npm install -g finmap-mcp

# Or use directly
npx finmap-mcp

Claude Desktop Configuration:

{
  "mcpServers": {
    "finmap": {
      "command": "npx",
      "args": ["-y", "bach-finmap-mcp"]
    }
  }
}

Available Tools

1. list_exchanges

  • Title: List exchanges

  • Description: Return supported exchanges with IDs, names, country, currency, earliest available date, and update frequency.

Example Promt: #finmap-mcp list available stock exchanges

Example Response:

{
  "exchanges": [
    {
      "id": "amex",
      "name": "American Stock Exchange",
      "country": "United States",
      "currency": "USD",
      "availableSince": "2024-12-09",
      "updateFrequency": "Daily"
    },
    {
      "id": "nasdaq",
      "name": "NASDAQ Stock Market",
      "country": "United States",
      "currency": "USD",
      "availableSince": "2024-12-09",
      "updateFrequency": "Daily"
    },
    {
      "id": "nyse",
      "name": "New York Stock Exchange",
      "country": "United States",
      "currency": "USD",
      "availableSince": "2024-12-09",
      "updateFrequency": "Daily"
    },
    {
      "id": "us-all",
      "name": "US Combined (AMEX + NASDAQ + NYSE)",
      "country": "United States",
      "currency": "USD",
      "availableSince": "2024-12-09",
      "updateFrequency": "Daily"
    },
    {
      "id": "lse",
      "name": "London Stock Exchange",
      "country": "United Kingdom",
      "currency": "GBP",
      "availableSince": "2025-02-07",
      "updateFrequency": "Hourly (weekdays)"
    },
    {
      "id": "moex",
      "name": "Moscow Exchange",
      "country": "Russia",
      "currency": "RUB",
      "availableSince": "2011-12-19",
      "updateFrequency": "Every 15 minutes (weekdays)"
    },
    {
      "id": "bist",
      "name": "Borsa Istanbul",
      "country": "Turkey",
      "currency": "TRY",
      "availableSince": "2015-11-30",
      "updateFrequency": "Every two months"
    },
    {
      "id": "hkex",
      "name": "Hong Kong Stock Exchange",
      "country": "Hong Kong",
      "currency": "HKD",
      "availableSince": "2025-09-26",
      "updateFrequency": "Every 30 minutes (weekdays)"
    }
  ]
}

2. list_sectors

  • Title: List sectors

  • Description: List available business sectors for an exchange on a specific date, including item counts.

Example Promt: #finmap-mcp List sectors for the Turkish stock exchange

Example Response:

{
  "date": "2024-08-28",
  "exchange": "BIST",
  "currency": "TRY",
  "sectors": [
    {
      "name": "Finance",
      "itemsPerSector": 164
    },
    {
      "name": "MSPOTECW",
      "itemsPerSector": 4669
    },
    {
      "name": "MSPOTEPW",
      "itemsPerSector": 3335
    },
    {
      "name": "Industrials",
      "itemsPerSector": 277
    },
    {
      "name": "MSPOTXCR",
      "itemsPerSector": 2
    },
    {
      "name": "Real Estate",
      "itemsPerSector": 4
    },
    {
      "name": "Agriculture",
      "itemsPerSector": 5
    },
    {
      "name": "Utilities",
      "itemsPerSector": 32
    },
    {
      "name": "MSPOTGMF",
      "itemsPerSector": 9
    },
    {
      "name": "Technology",
      "itemsPerSector": 39
    },
    {
      "name": "Basic Materials",
      "itemsPerSector": 7
    },
    {
      "name": "MSPOTEMS",
      "itemsPerSector": 1
    },
    {
      "name": "MSPOTETF",
      "itemsPerSector": 21
    },
    {
      "name": "MSPOTGSF",
      "itemsPerSector": 8
    },
    {
      "name": "Consumer Staples",
      "itemsPerSector": 27
    },
    {
      "name": "Consumer Discretionary",
      "itemsPerSector": 14
    },
    {
      "name": "Health Care",
      "itemsPerSector": 9
    },
    {
      "name": "Miscellaneous",
      "itemsPerSector": 13
    },
    {
      "name": "Telecommunications",
      "itemsPerSector": 7
    },
    {
      "name": "MSPOTEQT",
      "itemsPerSector": 4
    }
  ]
}

3. list_tickers

  • Title: List tickers by sector

  • Description: Return company tickers and names for an exchange on a specific date, grouped by sector.

Example Promt: #finmap-mcp List companies in the Real Estate sector

Example Response:

{
  "date": "2024-08-28",
  "exchange": "BIST",
  "currency": "TRY",
  "sectors": {
    "Real Estate": [
      {
        "ticker": "ADESE.E",
        "name": "ADESE GAYRIMENKUL"
      },
      {
        "ticker": "IHLGM.E",
        "name": "IHLAS GAYRIMENKUL"
      },
      {
        "ticker": "RGYAS.E",
        "name": "RONESANS GAYRIMENKUL YAT."
      },
      {
        "ticker": "SONME.E",
        "name": "SONMEZ FILAMENT"
      }
    ]
  }
}

4. search_companies

  • Title: Search companies

  • Description: Find companies by partial name or ticker on an exchange and return best matches.

Example Promt: #finmap-mcp Search for companies named 'Sprouts'

Example Response:

{
  "date": "2025-08-28",
  "exchange": "NASDAQ",
  "currency": "USD",
  "query": "Sprouts",
  "matches": [
    {
      "ticker": "SFM",
      "name": "Sprouts Farmers Market Inc. Common Stock",
      "sector": "Consumer Staples",
      "score": 70
    }
  ]
}

5. get_market_overview

  • Title: Market overview

  • Description: Get total market cap, volume, value, and performance for an exchange on a specific date with a sector breakdown.

Example Promt: #finmap-mcp market overview for Nasdaq

Example Response:

{
  "date": "2025-08-28",
  "exchange": "NASDAQ",
  "currency": "USD",
  "marketTotal": {
    "name": "Market",
    "marketCap": 41238186996017,
    "marketCapChangePct": 0.6213636439596683,
    "volume": 7606048313,
    "value": 0,
    "numTrades": 0,
    "itemsPerSector": 7974
  },
  "sectors": [
    {
      "name": "Basic Materials",
      "marketCap": 248122454077,
      "marketCapChangePct": -0.19965738920998274,
      "volume": 40489423,
      "value": 0,
      "numTrades": 0,
      "itemsPerSector": 36
    },
    {
      "name": "Consumer Discretionary",
      "marketCap": 5313249666194,
      "marketCapChangePct": 0.5556221951442668,
      "volume": 1029152348,
      "value": 0,
      "numTrades": 0,
      "itemsPerSector": 580
    },
    {
      "name": "ETFS",
      "marketCap": 0,
      "marketCapChangePct": null,
      "volume": 0,
      "value": 0,
      "numTrades": 0,
      "itemsPerSector": 3976
    },
    ...
    {
      "name": "Utilities",
      "marketCap": 333109407104,
      "marketCapChangePct": -0.1881153782118469,
      "volume": 39232326,
      "value": 0,
      "numTrades": 0,
      "itemsPerSector": 48
    }
  ]
}

6. get_sectors_overview

  • Title: Sector performance

  • Description: Get aggregated performance metrics by sector for an exchange on a specific date.

Example Promt: #finmap-mcp Get overview for the Utilities sector

Example Response:

{
  "date": "2025-08-28",
  "exchange": "NASDAQ",
  "currency": "USD",
  "sectors": [
    {
      "name": "Utilities",
      "marketCap": 333109407104,
      "marketCapChangePct": -0.1881153782118469,
      "volume": 39232326,
      "value": 0,
      "numTrades": 0,
      "itemsPerSector": 48
    }
  ]
}

7. get_stock_data

  • Title: Stock data by ticker

  • Description: Get detailed market data for a specific ticker on an exchange and date, including price, change, volume, value, market cap, and trades.

Example Promt: #finmap-mcp Dominion Energy, stock data

Example Response:

{
  "exchange": "nyse",
  "country": "United States",
  "currency": "USD",
  "sector": "Utilities",
  "ticker": "D",
  "nameEng": "Dominion Energy Inc. Common Stock",
  "nameOriginal": "",
  "priceOpen": 60.34,
  "priceLastSale": 59.81,
  "priceChangePct": -0.878,
  "volume": 3771759,
  "value": 0,
  "numTrades": 0,
  "marketCap": 51043865111,
  "listedFrom": "",
  "listedTill": ""
}

8. rank_stocks

  • Title: Rank stocks

  • Description: Rank stocks on an exchange by a chosen metric (marketCap, priceChangePct, volume, value, numTrades) for a specific date with order and limit.

Example Promt: #finmap-mcp UK, rank stocks by market cap

Example Response:

{
  "date": "2025-08-28",
  "exchange": "LSE",
  "currency": "GBP",
  "sortBy": "marketCap",
  "order": "desc",
  "limit": 5,
  "count": 5,
  "stocks": [
    {
      "ticker": "AZN",
      "name": "ASTRAZENECA PLC ORD SHS $0.25",
      "sector": "Health Care",
      "priceLastSale": 11810,
      "priceChangePct": -0.5557426743011115,
      "marketCap": 184159063201,
      "volume": 0,
      "value": 0,
      "numTrades": 0
    },
    {
      "ticker": "HSBA",
      "name": "HSBC HLDGS PLC ORD $0.50 (UK REG)",
      "sector": "Finance",
      "priceLastSale": 955.8,
      "priceChangePct": 0.1676797317124293,
      "marketCap": 165599631829,
      "volume": 0,
      "value": 0,
      "numTrades": 0
    },
    {
      "ticker": "SHEL",
      "name": "SHELL PLC ORD EUR0.07",
      "sector": "Energy",
      "priceLastSale": 2715.5,
      "priceChangePct": 0,
      "marketCap": 158779785181,
      "volume": 0,
      "value": 0,
      "numTrades": 0
    },
    {
      "ticker": "ULVR",
      "name": "UNILEVER PLC ORD 3 1/9P",
      "sector": "Consumer Staples",
      "priceLastSale": 4610,
      "priceChangePct": -0.2812026822409691,
      "marketCap": 113348756395,
      "volume": 0,
      "value": 0,
      "numTrades": 0
    },
    {
      "ticker": "BHP",
      "name": "BHP GROUP LIMITED ORD NPV (DI)",
      "sector": "Basic Materials",
      "priceLastSale": 2073,
      "priceChangePct": 0.6310679611650485,
      "marketCap": 104611160052,
      "volume": 0,
      "value": 0,
      "numTrades": 0
    }
  ]
}

9. get_company_profile

  • Title: Company profile (US)

  • Description: Get business description, industry, and background for a US-listed company by ticker.

Example Promt: #finmap-mcp Sprouts Farmers Market, get company profile

Example Response:

{
  "data": {
    "ModuleTitle": {
      "label": "Module Title",
      "value": "Company Description"
    },
    "CompanyName": {
      "label": "Company Name",
      "value": "Sprouts Farmers Market, Inc."
    },
    "Symbol": {
      "label": "Symbol",
      "value": "SFM"
    },
    "Address": {
      "label": "Address",
      "value": "5455 EAST HIGH STREET,SUITE 111, PHOENIX, Arizona, 85054, United States"
    },
    "Phone": {
      "label": "Phone",
      "value": "+1 480 814-8016"
    },
    "Industry": {
      "label": "Industry",
      "value": "Food Chains"
    },
    "Sector": {
      "label": "Sector",
      "value": "Consumer Staples"
    },
    "Region": {
      "label": "Region",
      "value": "North America"
    },
    "CompanyDescription": {
      "label": "Company Description",
      "value": "Sprouts Farmers Market is an American specialty grocer offering an assortment highlighting fresh and naturally derived products. Its offerings   are especially focused on produce, which constituted around 21% of sales in fiscal 2021. Founded in 2002, the chain is most heavily concentrated in   California, which accounted for over one third of its 374 stores as of the end of fiscal 2021. All of the company's operations are in the United States,   with its stores largely located in the southern half of the country. The firm sells roughly 20,000 products (of which around 70% are attribute driven,   such as organic, plant-based, or catering to the keto or paleo diet), with private-label products accounting for about 16% of sales in fiscal 2021.   Perishable items accounted for 58% of fiscal 2021 sales."
    },
    "CompanyUrl": {
      "label": "Company Url",
      "value": "https://www.sprouts.com"
    },
    "KeyExecutives": {
      "label": "Key Executives",
      "value": [
        {
          "name": "Jack Loudon Sinclair",
          "title": "Chief Executive Officer & Director"
        },
        {
          "name": "James Bahrenburg",
          "title": "Chief Technology Officer"
        },
        {
          "name": "Nicholas Konat",
          "title": "President & Chief Operating Officer"
        }
      ]
    }
  },
  "message": null,
  "status": {
    "rCode": 200,
    "bCodeMessage": null,
    "developerMessage": null
  }
}

Data Provider

Data is sourced from finmap.org - an interactive platform for financial market visualization and analysis.

Available Tools

9 tools
get_company_profileCompany profile (US)A

Get business description, industry, and background for a US-listed company by ticker.

Inputs: exchange (required), ticker (required).

get_market_overviewMarket overviewC

Get total market cap, volume, value, and performance for an exchange on a specific date with a sector breakdown.

Inputs: stockExchange (required), year, month, day.

get_sectors_overviewSector performanceC

Get aggregated performance metrics by sector for an exchange on a specific date.

Inputs: stockExchange (required), year, month, day, +1 more.

get_stock_dataStock data by tickerC

Get detailed market data for a specific ticker on an exchange and date, including price, change, volume, value, market cap, and trades.

Inputs: stockExchange (required), ticker (required), year, month, +1 more.

list_exchangesList exchangesB

Return supported exchanges with IDs, names, country, currency, earliest available date, and update frequency.

Inputs: no named parameters.

list_sectorsList sectorsC

List available business sectors for an exchange on a specific date, including item counts.

Inputs: stockExchange (required), year, month, day.

list_tickersList tickers by sectorC

Return company tickers and names for an exchange on a specific date, grouped by sector.

Inputs: stockExchange (required), year, month, day, +2 more.

rank_stocksRank stocksC

Rank stocks on an exchange by a chosen metric (marketCap, priceChangePct, volume, value, numTrades) for a specific date with order and limit.

Inputs: stockExchange (required), sortBy (required), year, month, +4 more.

search_companiesSearch companiesB

Find companies by partial name or ticker on an exchange and return best matches

Inputs: stockExchange (required), query (required), year, month, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific financial data retrieval operations. For example, get_company_profile focuses on business background, get_stock_data on detailed market metrics, and rank_stocks on comparative ranking - there's no functional overlap that would cause agent confusion.

    Naming Consistency5/5

    All tools follow a consistent verb_noun naming pattern (get_, list_, rank_, search_) with clear, descriptive nouns. The naming convention is uniformly applied across all nine tools, making them predictable and easily parsable by agents.

    Tool Count5/5

    Nine tools is an ideal number for this financial data server's scope. It provides comprehensive coverage without being overwhelming, with each tool serving a distinct, necessary function in the financial data analysis workflow.

    Completeness4/5

    The toolset provides excellent coverage for financial data retrieval and analysis, including company profiles, market/sector overviews, detailed stock data, listings, ranking, and search. A minor gap exists in update/write operations, but this is appropriate for a data retrieval-focused server, and agents can work effectively with the provided read-only surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides comprehensive stock market data across US, Hong Kong, and Chinese markets, combining real-time quotes, historical data, fundamentals, and financial statements from multiple sources including Yahoo Finance, Finnhub, Tushare, and Futu OpenAPI.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables access to real-time and historical market data including stocks, ETFs, forex, and cryptocurrencies, with support for time series, quotes, dividends, splits, and earnings.
      325 npm
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Provides stock market data and analysis tools using the Finnhub API, including stock prices, financial metrics, news, and historical data.
      6
      7
      -