Log inSubmit server
MCP Server logo

MCP Server

by finmap-org

Explore historical stock-market data, company listings, sectors, market statistics, and visualizations across eight supported exchanges.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "finmap-org-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "finmap-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

finmap-org/mcp-server connects MCP clients to finmap.org's market dataset for exchanges including NYSE, NASDAQ, LSE, MOEX, BIST, and HKEX. It supports exchange discovery, sector and company lookup, company search, and market-overview analysis using date- and exchange-based queries. Use it to research listed companies, compare sector composition, or inspect market capitalization, volume, traded value, and trade counts. The service is available through a hosted endpoint or as a local npm package, with an HTTP API wrapper for direct integrations and GPT Actions.

Use cases

  • List sectors and companies on a selected exchange for a trading date
  • Search exchange listings by ticker or company name
  • Compare market capitalization and volume across sectors
  • Inspect historical market activity for supported exchanges
  • Expose stock data to GPT Actions through the HTTP wrapper

Key features

  • Historical data across eight stock-market views
  • Exchange, sector, ticker, and company-directory queries
  • Relevance-ranked company search
  • Market capitalization, volume, value, and trade statistics
  • Hosted MCP endpoint and local npm package
  • HTTP API with OpenAPI and GPT Actions support

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · finmap-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars15Stargazers on the source repository.
npm downloads1.6kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server works

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server

finmap-org/mcp-server is an MCP server that connects AI clients to finmap.org stock-market data for US, UK, Hong Kong, Russian, and Turkish exchanges. Its main tools list exchanges and sectors, find companies by ticker or name, return sector listings, and analyze market overviews with capitalization, volume, traded value, and trade counts.

Install it locally with `npm install -g finmap-mcp`, or run it directly with `npx finmap-mcp`. For a hosted connection, configure an MCP client to run `npx mcp-remote https://mcp.finmap.org`; the project gives this setup for Claude Desktop.

It supports NYSE, NASDAQ, AMEX, a combined US view, LSE, HKEX, BIST, and MOEX. The exchange metadata tool also reports each market's country, currency, earliest available date, and update frequency.

Yes. The server exposes an HTTP wrapper with an OpenAPI document and routes for exchanges, sectors, companies, market overviews, sector performance, stock rankings, stock snapshots, and company profiles. A `gpt-actions.yaml` schema is available for GPT Actions.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/finmap-org-mcp-server?style=directory)](https://allmcps.com/mcp/finmap-org-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/finmap-org-mcp-server"><img src="https://allmcps.com/api/badge/finmap-org-mcp-server?style=directory" alt="MCP Server on AllMCPs" /></a>