MCP.so
Sign In
M

Market Data Mcp

@cstamigo-droid

Repository

About Market Data Mcp

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "market-data-mcp": {
      "command": "python",
      "args": [
        "-m",
        "market_data_mcp"
      ],
      "cwd": "C:/path/to/market-data-mcp"
    }
  }
}

Tools

6

Real-time price, % change, high/low/open/prev-close

Top 5 headlines — company-specific or general market

Earnings calendar for the next N days (with EPS/revenue estimates)

Watchlist scanner: rank up to 25 tickers by absolute % change

Composite: momentum score + news catalyst + earnings proximity

Read open positions from Alpaca paper account

Overview

What is Market Data Mcp?

Market Data Mcp is a Model Context Protocol server that provides real-time market data—quotes, news, earnings calendars, and a watchlist scanner—to AI agents. It integrates with Finnhub as its primary data source and optionally Alpaca for broker positions. Designed for any MCP client (e.g., Claude Desktop, Claude Code), it returns clean, uniform results that fail gracefully rather than fabricating values.

How to use Market Data Mcp?

Clone the repository, create a Python virtual environment, install dependencies, and configure a .env file with FINNHUB_API_KEY. Run the server via python -m market_data_mcp. Add a mcpServers entry to your Claude Desktop configuration file. Tools are invoked by name (e.g., market_quote, market_scan) and return Markdown by default or JSON with response_format="json".

Key features of Market Data Mcp

  • Real-time quotes, news, earnings calendar, and watchlist scanner.
  • Composite analysis tool with directional score and confidence.
  • Uniform Result contract across all tools (source, ok, summary, data, score, confidence, error).
  • Graceful degradation: missing or premium-gated data returns Result.failed, never a fabricated value.
  • Per-source TTL cache to respect API rate limits.
  • Optional Alpaca paper account integration for reading open positions.

Use cases of Market Data Mcp

  • Ask an AI agent for the current price and daily change of a stock.
  • Get the top 5 market headlines or company-specific news.
  • Retrieve upcoming earnings calendar events with EPS and revenue estimates.
  • Scan a watchlist of up to 25 tickers and rank them by absolute percentage change.
  • Perform a composite analysis of a ticker including momentum, news catalyst, and earnings proximity.
  • Read open positions from an Alpaca paper trading account.

FAQ from Market Data Mcp

What data sources does Market Data Mcp use?

The primary source is Finnhub. The broker_positions tool optionally uses Alpaca’s Paper Trading API if API keys are provided.

Does Market Data Mcp require an API key?

Yes, you need a free Finnhub API key, obtainable at https://finnhub.io/register. The Alpaca keys are optional.

Are the tools free to use?

Most tools operate on Finnhub’s free tier. The earnings calendar tool was verified live on 2026-06-14 and accessible on the free tier. The broker_positions tool requires Alpaca keys but is free for paper trading.

What transport does Market Data Mcp use?

It uses the standard MCP transport over stdio, configured via Claude Desktop’s mcpServers JSON with a command and args pointing to the Python module.

What happens when data is unavailable?

The server returns a Result.failed object with an error message. It never fabricates a value—missing or premium-gated sources produce “no data.”

Frequently asked questions

What data sources does Market Data Mcp use?

The primary source is Finnhub. The `broker_positions` tool optionally uses Alpaca’s Paper Trading API if API keys are provided.

Does Market Data Mcp require an API key?

Yes, you need a free Finnhub API key, obtainable at https://finnhub.io/register. The Alpaca keys are optional.

Are the tools free to use?

Most tools operate on Finnhub’s free tier. The earnings calendar tool was verified live on 2026-06-14 and accessible on the free tier. The `broker_positions` tool requires Alpaca keys but is free for paper trading.

What transport does Market Data Mcp use?

It uses the standard MCP transport over stdio, configured via Claude Desktop’s `mcpServers` JSON with a `command` and `args` pointing to the Python module.

What happens when data is unavailable?

The server returns a `Result.failed` object with an error message. It never fabricates a value—missing or premium-gated sources produce “no data.”

Comments

Basic information

Category

Data & Analytics

Transports

stdio

Author

cstamigo-droid

Submitted by

cstamigo-droid

More Data & Analytics MCP servers

Sugra API MCP

Sugra Systems, Inc.

Official MCP server for the Sugra API, giving AI agents source-attributed access to 1,500+ endpoints across 36 data domains from 160+ primary sources. Covers markets, economics, company fundamentals, government, news, cl

1
B

BidSkim - UK Tenders & Contract Renewals

BidSkim

UK procurement intelligence for AI assistants: search live UK government tenders, find contract renewals with expiry dates and incumbent suppliers, and profile public-sector buyers and suppliers. Covers Find a Tender, Co

S

Stratyfix

Stratyfix

Stratyfix is an AI-driven sales intelligence platform. This connector lets managers and reps ask about their own Stratyfix data in the chat they already use. Are we going to make the quarter? Who needs my attention this

SiteGuru

Your site's real SEO data in your AI assistant. SiteGuru crawls your website and connects to Google Search Console and Google Analytics. This server exposes that data to your assistant, so you can ask what's broken, wha

ScrapeCheck

FieldmodeLLC

Verify scraped data against the live source page. Signed verdicts, $0.01 via x402.