finmap-org/mcp-server

The 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.
Supported Exchanges
| Exchange | Code | Country | Earliest Data | Update Frequency |
|----------|------|---------|---------------|------------------|
| New York Stock Exchange | nyse | United States | 2024-12-09 | Daily |
| NASDAQ Stock Market | nasdaq | United States | 2024-12-09 | Daily |
| American Stock Exchange | amex | United States | 2024-12-09 | Daily |
| US Combined (AMEX + NASDAQ + NYSE) | us-all | United States | 2024-12-09 | Daily |
| London Stock Exchange | lse | United Kingdom | 2025-02-07 | Hourly (weekdays) |
| Hong Kong Stock Exchange | hkex | Hong Kong | 2025-09-29 | Every 30 minutes (weekdays) |
| Borsa Istanbul | bist | Turkey | 2015-11-30 | Every two months |
| Moscow Exchange | moex | Russia | 2011-12-19 | Every 15 minutes (weekdays) |
Installation & Usage
Option 1: Remote Server (Hosted)
Connect to our hosted MCP server without any installation:
**Server URL**: https://mcp.finmap.org
**Claude Desktop Configuration**:
Option 2: Local Package (npm)
Install and run locally for better performance and offline access:
**Claude Desktop Configuration**:
HTTP API Wrapper
The server also exposes a compact HTTP API for GPT Actions and direct integration.
- GET /api/openapi.json
- GET /api/list-exchanges
- POST /api/list-sectors
- POST /api/list-sector-companies
- POST /api/search-companies
- POST /api/market-overview
- POST /api/sector-performance
- POST /api/rank-stocks
- POST /api/stock-snapshot
- POST /api/company-profile
A ready-to-import GPT Actions schema is available in gpt-actions.yaml.
Available Tools
1. list_supported_exchanges
- Title: List supported stock exchanges
- Description: Return metadata for all supported stock exchanges in the Finmap dataset. Includes exchange ID, exchange name, country, currency, earliest available historical data date, and update frequency.
**Example Prompt:** #finmap-mcp list available stock exchanges
**Example Response:**
2. list_exchange_sectors
- Title: List sectors for a stock exchange
- Description: Return all business sectors available on a specific exchange and trading date. Each sector includes the number of companies in that sector.
**Example Prompt:** #finmap-mcp List sectors for the Turkish stock exchange
**Example Response:**
3. list_sector_companies
- Title: List companies by sector
- Description: Return company tickers and names grouped by sector for an exchange on a specific trading date. Optionally filter results by a single sector.
**Example Prompt:** #finmap-mcp List companies in the Real Estate sector
**Example Response:**
4. search_exchange_companies
- Title: Search companies by name or ticker
- Description: Search for companies on a specific exchange by partial ticker symbol or company name. Results are ranked by relevance using ticker and name similarity.
**Example Prompt:** #finmap-mcp Search for companies named 'Sprouts'