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

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/finmap-org/mcp-server  
**GitHub Stars:** 15  
**npm Downloads (last month):** 1633  
**Views:** 7  
**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

finmap-org/mcp-server exposes finmap.org market data through the Model Context Protocol. Its dataset covers the New York Stock Exchange, NASDAQ, American Stock Exchange, a combined US market view, the London Stock Exchange, Hong Kong Stock Exchange, Borsa Istanbul, and Moscow Exchange. Each exchange has its own identifier, currency, historical coverage, and update schedule.

The data is organized around trading dates and exchanges. Depending on the query, results can include sectors, company names, ticker symbols, market capitalization, trading volume, traded value, trade counts, and sector-level market breakdowns. The service also supports treemap and histogram visualizations, as described by the project.

## How it works

MCP clients can connect to the hosted server at `https://mcp.finmap.org` through `mcp-remote`, or run the npm package locally with `finmap-mcp`. Requests identify an exchange and, for market and directory queries, generally use a trading date. Exchange metadata includes the earliest available date and refresh frequency, which helps determine the usable historical range and expected data freshness.

The exchange coverage varies by market. US exchange data begins on 2024-12-09 and is updated daily. LSE data begins on 2025-02-07 and updates hourly on weekdays. HKEX data begins on 2025-09-29 and updates every 30 minutes on weekdays. BIST coverage begins on 2015-11-30 with updates every two months, while MOEX data begins on 2011-12-19 and updates every 15 minutes on weekdays.

A separate HTTP wrapper provides JSON endpoints for applications that do not use MCP directly. It exposes an OpenAPI document, exchange listing, sector and company queries, market overview, sector performance, stock ranking, stock snapshots, and company profiles. A `gpt-actions.yaml` schema is available for GPT Actions imports.

## Setup and configuration

For a hosted connection, configure an MCP client to run `npx mcp-remote https://mcp.finmap.org`. The project shows this arrangement for Claude Desktop. No local package installation is needed for that connection.

For local use, install the package globally with `npm install -g finmap-mcp`, or start it without a global install using `npx finmap-mcp`. The example Claude Desktop configuration runs `npx -y finmap-mcp`. Local execution is intended for performance and offline access according to the project instructions.

The HTTP wrapper can be used through the documented GET and POST routes, including `/api/openapi.json` and `/api/list-exchanges`. No environment variables are shown in the setup examples.

## Tools and capabilities

- `list_supported_exchanges` returns exchange IDs, names, countries, currencies, earliest data dates, and update frequencies.
- `list_exchange_sectors` lists sectors and company counts for an exchange and trading date.
- `list_sector_companies` returns ticker and company-name listings by sector, with an optional single-sector filter.
- `search_exchange_companies` searches an exchange by partial ticker or company name and ranks matching results by relevance.
- `analyze_market_overview` returns market capitalization, market-cap change, volume, traded value, trade counts, and sector-level statistics.
- The HTTP API also exposes sector performance, stock ranking, stock snapshots, and company-profile routes.

## Limitations and notes

Historical availability and refresh timing differ by exchange, so a query's usable date range depends on the selected market. Results are tied to the exchange and date supplied to the tool. The combined `us-all` view represents AMEX, NASDAQ, and NYSE together rather than an additional exchange. Currency also varies by market, including USD, GBP, HKD, TRY, and RUB.

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