mcp

The Finmap MCP Server exposes a set of tools designed to fetch and explore historical stock market data across multiple exchanges. Available tools include: list_exchanges to enumerate supported exchanges with their IDs and update frequencies; list_sectors to list business sectors for a given exchange and date; list_tickers to retrieve tickers grouped by sector for a chosen exchange and date; search_companies to find companies by partial name or ticker on a specific exchange; and get_market_overview to obtain aggregate market metrics such as market cap, volume, value and a sector breakdown for a given date and exchange. These tools enable building visualizations (e.g., treemaps, histograms) and performing targeted queries against the historical data provided by the MCP backend. You can use either the remote hosted server or run the MCP locally via npm, depending on your environment and offline needs.

To use the remote server, point your client to https://mcp.finmap.org and configure the MCP connection as shown in the example. For local use, install the finmap-mcp package and run it via npx, which will serve the MCP endpoints locally for fast iterations and offline access. Tools respond with structured JSON you can feed into visualizations or further processing.

Prerequisites:

• Node.js (LTS version) and npm installed on your machine.
• Internet access to install npm packages or to access the remote MCP server.

Installation steps (local package):

1. Install the MCP client globally (optional):

npm install -g finmap-mcp

2. Or run directly with npx (no global install required):

npm init -y
npx finmap-mcp

3. Verify the server starts and is accessible (default port may be configured by the package). If you want to customize, refer to the package's documentation for environment variables and options.

Usage examples after installation:

• Using the remote MCP server:

# Configure via Claude Desktop (example)

• Using locally installed MCP client with npx:

npx -y finmap-mcp

Prerequisites recap:

• Node.js and npm installed
• Internet access for initial setup or access to local package cache
• Basic familiarity with JSON configuration for MCP clients

Notes and tips:

• The Finmap MCP Server provides access to historical data across NYSE, NASDAQ, AMEX, US-all, LSE, HKEX, BIST, and MOEX. Availability and update frequency per exchange are listed in the README.
• Remote usage is convenient for quick testing or when local setup is not desired. Local usage improves performance and enables offline access once data is cached.
• If you encounter connectivity issues, verify your network, and ensure the MCP service URL is reachable when using the remote server. For local runs, check that Node.js is functioning and that the finmap-mcp package can be resolved by npm.
• Environment variables or additional config options (such as specific API endpoints, data ranges, or authentication) can be exposed by the MCP package; refer to the project docs for any advanced configuration.
• When using list_exchanges or market overview, dates should be in ISO format (YYYY-MM-DD). Output is designed to be directly consumable by visualization tools.