Market Data MCP Server

@cstamigo-droid

代码仓库

基本信息

分类

数据与分析

传输方式

stdio

作者

cstamigo-droid

提交者

cstamigo-droid

关于 Market Data MCP Server

暂无概览

Market Data MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Market Data MCP Server 工具

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

概览

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.

常见问题

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.”

数据与分析分类下的更多 MCP 服务器

Lawstronaut Legal Research

Lawstronaut-FZCO

Connect your AI to millions of laws and court cases! Lawstronaut is the infrastructure layer that connects AI agents and software to millions of legal documents across 150+ jurisdictions, structured legal data, continuou

AdLoop Cloud

kLOsk

Hosted AdLoop: Google Ads, Reddit Ads, GA4 and Tag Manager in claude.ai, ChatGPT and more, with a preview before every change.

NeuralVerge

NeuralVerge is the data layer for agentic AI. Ask a question in plain language and get a structured, cited answer drawn from 300+ sources — e-commerce marketplaces, corporate registries, company intelligence, enrichme

TikTok MCP Server

HasData

Hosted TikTok MCP server for AI agents: read public profiles, account videos, comments and replies, or search videos and creators. Structured JSON for creator research and content analysis.

Ultimate Web Scraper

Extract products, prices, images and reviews from any page in one click — or connect your AI agent and let it do the scraping for you. Works great for: - Ecommerce: extract every product from a Shopify, WooCommerce or