Finmap

The Finmap MCP Server provides access to historical stock market data from multiple exchanges, enabling you to explore sectors, tickers, company profiles, market metrics, and visualizations through a lightweight MCP client. It supports data from the US, UK, Russia, and Turkey, making it practical for research, analytics, and decision support across diverse markets.

How to use

You connect your MCP client to either the hosted Finmap MCP server or a local MCP runtime to start querying data and performing analyses. Use the hosted server for quick access without installation, or run the local package for lower latency and offline access. You can list available exchanges, drill into sectors and tickers, fetch market overviews, compare stocks by metrics, and look up company profiles. Your client will expose a set of endpoints that correspond to the MCP tools described in the available features.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Option A — Remote server (hosted) is ready to use without installation.

Option B — Local package (npm) for better performance and offline access.

Follow these concrete steps to run locally:

# Install globally
npm install -g finmap-mcp

# Or run directly without installing
npx finmap-mcp

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

Additional notes

MCP tools cover a broad range of data queries and insights, including listing exchanges, listing sectors, listing tickers by sector, searching companies, market overviews, sector overviews, stock data by ticker, ranking stocks, and fetching company profiles for the US market.

Available tools

list_exchanges

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

list_sectors

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

list_tickers

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

search_companies

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

get_market_overview

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

get_sectors_overview

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

get_stock_data

Get detailed market data for a specific ticker on an exchange and date.

rank_stocks

Rank stocks on an exchange by a chosen metric for a specific date with order and limit.

get_company_profile

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