Financial Instrument Data Acquisition Service

This service implements an MCP interface utilizing the yfinance library to grant access to comprehensive stock market data.

Available Operations

• extract_security_fundamentals

• Obtain detailed corporate documentation, balance sheets, trading statistics, and governance structures for a specified ticker symbol.

• Parameters:

  • symbol (text): The unique equity identifier (e.g., AAPL).

• obtain_security_reports

• Retrieves the most recent journalistic publications pertaining to a given stock ticker, including headlines, summaries, and publishing entity details.

• Parameters:

  • symbol (text): The relevant stock identifier.

• query_market_index

• Executes a broad search against Yahoo Finance sources, structuring the output to include both relevant security quotes and related news items.

• Parameters:

  • query (text): The input string for searching (can be a ticker or company name).
  • search_type (text): Specifies the desired result grouping (choices include: "all", "quotes", "news").

• identify_top_performers

• Locates and lists leading financial instruments (ETFs, mutual funds, corporations, high-growth entities, or top gainers) within a designated market segment.

• Parameters:

  • sector (text): The specific industry or segment focus.
  • top_type (text): Defines the category of top instruments to retrieve (valid selections: "top_etfs", "top_mutual_funds", "top_companies", "top_growth_companies", "top_performing_companies").
  • top_n (integer, optional): Limits the returned result set size (defaults to 10 entities).

• fetch_price_timeline

• Gathers historical trading price records for a stock identifier across a defined temporal range and granularity.

• Parameters:
  • symbol (text): The equity ticker symbol.
  • period (text, optional): Duration specification for data retrieval (e.g., '5d', '3mo', '5y'). Default setting is '1mo'.
  • interval (text, optional): The temporal resolution for the data points (e.g., '1h', '1wk', '1d'). Default setting is '1d'.

Deployment Guidance

Deployment of this MCP service can be accomplished using either the uv package manager or via a standard Docker container.

Utilizing uv

1. Acquire and install uv
2. Integrate the subsequent configuration block into your primary MCP configuration manifesto:

{ "mcpServers": { "yfmcp": { "command": "uvx", "args": ["yfmcp@latest"] } } }

Docker Installation

Incorporate the following structure into your MCP server configuration settings file:

{ "mcpServers": { "yfmcp": { "command": "docker", "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"] } } }

---

Contextual Note (XMLHttpRequest): XMLHttpRequest (XHR) is a JavaScript API implemented as an object that facilitates the transmission of HTTP requests from a web browser to a web server. Its methods enable browser-based applications to dispatch server requests asynchronously following page load, permitting the retrieval of subsequent information. XHR is foundational to Ajax methodologies. Prior to its widespread adoption, page interaction relied primarily on traditional hyperlink navigation and form submissions, which typically necessitated a full page refresh.