Finmap

The Finmap MCP Server provides centralized access to historical market data from multiple major exchanges. You can query sectors, tickers, company profiles, market metrics, and visualize data, all through an MCP client that connects to either a remote host or a local npm-driven server. This makes it easier to build dashboards, perform analyses, and integrate market data into your workflows.

How to use

To use the Finmap MCP Server, connect your MCP client to one of the available endpoints. You can choose a remote hosted server for a quick setup, or run a local MCP server on your machine for better performance and offline access.

How to install

Prerequisites: You need Node.js installed on your system. If you prefer a hosted option, you do not need to install anything locally.

# Install the local MCP server bundle globally
npm install -g finmap-mcp

# Or run directly without installing
npx finmap-mcp

Additional notes

There are two primary ways to connect to the Finmap MCP Server. You can use the remote hosted endpoint or run a local instance with the provided package. Both options expose the same MCP tools and data endpoints.

Configuration examples

If you want to connect to the remote hosted server, you can configure your MCP client with the following HTTP config.

{
  "mcpServers": {
    "finmap_http": {
      "type": "http",
      "name": "finmap_http",
      "url": "https://mcp.finmap.org",
      "args": []
    }
  }
}

Local npm-based server configuration

If you prefer running a local MCP server for better performance or offline access, use the runtime command shown.

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

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, including price, change, volume, value, market cap, and trades.

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.