# finmap-org/mcp-server [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/finmap-org/mcp-server  
**GitHub Stars:** 14  
**npm Downloads (last month):** 992  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/finmap-org-mcp-server

## Description
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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-server": {
    "command": "npx",
    "args": ["-y","finmap-mcp"]
  }
}
```

## Documentation

## What finmap-org/mcp-server does

The finmap-org/mcp-server MCP server gives AI clients access to historical and exchange-level stock-market data from Finmap. Supported venues include NYSE, NASDAQ, AMEX, a combined US dataset, LSE, HKEX, Borsa Istanbul, and Moscow Exchange. Returned records can include exchange metadata, sectors, company tickers and names, market capitalization, trading volume, traded value, trade counts, and company profiles.

The dataset is organized around trading dates and exchanges. Agents can inspect which exchanges are available, enumerate sectors, find companies by sector, search using a ticker or partial company name, and request aggregated market statistics. The project description also identifies treemap and histogram visualizations as part of the available Finmap data experience.

## How it works

MCP-compatible clients call named tools with an exchange and, where applicable, a trading date or search term. `list_supported_exchanges` returns country, currency, earliest available date, and update frequency. `list_exchange_sectors` reports sectors and company counts for an exchange and date, while `list_sector_companies` returns ticker-name pairs, optionally limited to one sector.

For discovery, `search_exchange_companies` ranks matches for a partial ticker or company-name query. `analyze_market_overview` aggregates market capitalization, market-cap change, volume, traded value, trade counts, and sector-level breakdowns. The same project also exposes HTTP endpoints for exchange lists, sector queries, company searches, market overviews, sector performance, stock rankings, snapshots, and company profiles. An OpenAPI document and GPT Actions schema are provided for those HTTP integrations.

## Setup and configuration

The finmap-org/mcp-server MCP server can be used through the hosted endpoint at `https://mcp.finmap.org`, avoiding local installation. The README provides a Claude Desktop configuration for that endpoint, using `mcp-remote` as the client-side bridge.

For local execution, run the published npm package with:

```bash
npx -y finmap-mcp
```

The README also documents global installation with `npm install -g finmap-mcp`. Its local setup is described as suitable when local performance or offline access is preferred. No API key, token, or environment variable is documented in the supplied material.

## Tools and capabilities

The documented MCP tools cover:

- Listing supported exchanges and their data coverage.
- Listing sectors and company counts for a dated exchange snapshot.
- Listing companies within all sectors or one selected sector.
- Searching companies by ticker or name with relevance scores.
- Summarizing market and sector statistics for a trading date.
- Accessing related HTTP operations for rankings, snapshots, performance, and profiles.

## Limitations and notes

Coverage is not uniform across exchanges. US datasets begin on 2024-12-09 and update daily; LSE data begins on 2025-02-07 and updates hourly on weekdays; HKEX begins on 2025-09-29 and updates every 30 minutes on weekdays. Borsa Istanbul begins on 2015-11-30 and updates every two months, while Moscow Exchange begins on 2011-12-19 and updates every 15 minutes on weekdays. Confirm the requested date against the selected exchange's available history and schedule before relying on a result.

## Getting started with this finmap-org/mcp-server MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/finmap-org-mcp-server/readme_