Skip to main content
Glama
chintan-diwakar

Zentickr - Yahoo Finance MCP Server

Zentickr — Yahoo Finance MCP Server

Zentickr is a stdio-based Model Context Protocol (MCP) server that gives AI assistants access to 23 Yahoo Finance tools through the yahooquery library—covering prices, fundamentals, statements, analyst research, ownership, events, and symbol discovery.

MIT License CI Python >=3.10

⚠️ Important Disclaimer

This software is provided for educational and informational purposes only. It does not provide financial, investment, legal, or tax advice. Market data may be delayed, incomplete, or inaccurate. You are solely responsible for your investment decisions; the authors are not liable for any losses or damages arising from use of this software.

Related MCP server: MCP Yahoo Finance

Quickstart

git clone https://github.com/chintan-diwakar/zentickr-yahoo-query-mcp.git
cd zentickr-yahoo-query-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e .

Run the server over stdio:

zentickr

Or:

python -m zentickr

Client setup

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "zentickr": {
      "command": "/absolute/path/to/zentickr-yahoo-query-mcp/.venv/bin/zentickr"
    }
  }
}

Claude Code

claude mcp add zentickr -- /absolute/path/to/zentickr-yahoo-query-mcp/.venv/bin/zentickr

Cursor

Create or update .cursor/mcp.json:

{
  "mcpServers": {
    "zentickr": {
      "command": "/absolute/path/to/zentickr-yahoo-query-mcp/.venv/bin/zentickr"
    }
  }
}

Real-world use cases

Compare Apple and Microsoft fundamentals

Prompt: “Compare Apple and Microsoft fundamentals.”

The assistant can call get_financial_data(symbols="AAPL,MSFT") and get_valuation_measures(symbols="AAPL,MSFT").

Captured output excerpt:

Financial Data:
{
  "AAPL": {
    "currentPrice": 333.26,
    "targetHighPrice": 400.0,
    "targetLowPrice": 215.0,
    "targetMeanPrice": 315.78604,
    "recommendationKey": "buy",
    "numberOfAnalystOpinions": 43,
    "totalCash": 68507000832,
    "totalDebt": 84710998016,
    "totalRevenue": 451442016256,
    "earningsGrowth": 0.218,
    "revenueGrowth": 0.166
  }
}
Valuation Measures:
[
  {
    "symbol": "AAPL",
    "asOfDate": "2026-05-28 00:00:00",
    "periodType": "TTM",
    "ForwardPeRatio": 35.3357,
    "MarketCap": 4589945623560.0,
    "PbRatio": 43.101723,
    "PeRatio": 37.83414,
    "PegRatio": 2.7194
  }
]

Prep me for AAPL earnings

Prompt: “Prep me for AAPL earnings.”

The assistant can call get_calendar_events(symbols="AAPL") and get_earnings_trend(symbols="AAPL").

Captured output excerpts:

Calendar Events:
{
  "AAPL": {
    "earnings": {
      "earningsDate": [
        "2026-07-31 01:30:S"
      ],
      "earningsAverage": 1.89396,
      "earningsLow": 1.83,
      "earningsHigh": 1.99,
      "revenueAverage": 108890141050
    }
  }
}
Earnings Trend:
{
  "AAPL": {
    "trend": [
      {
        "period": "0q",
        "endDate": "2026-06-30",
        "growth": 0.20629999,
        "earningsEstimate": {
          "avg": 1.89396,
          "numberOfAnalysts": 31,
          "yearAgoEps": 1.57
        }
      }
    ]
  }
}

Find NVIDIA's ticker and current price

Prompt: “Find NVIDIA's ticker and current price.”

The assistant can call search_symbols(query="nvidia"), then get_price_data(symbols="NVDA").

Captured output excerpts:

Search Results for 'nvidia':
[
  {
    "symbol": "NVDA",
    "name": "NVIDIA Corporation",
    "type": "EQUITY",
    "exchange": "NMS"
  }
]
Price Data:
{
  "NVDA": {
    "preMarketPrice": 202.155,
    "regularMarketPrice": 207.4,
    "regularMarketDayHigh": 211.08,
    "regularMarketDayLow": 205.85,
    "regularMarketVolume": 116253420,
    "regularMarketPreviousClose": 212.5,
    "exchangeName": "NasdaqGS",
    "marketState": "PRE",
    "symbol": "NVDA"
  }
}

Tool catalog

Market Data

Tool

Arguments

Returns

get_price_data

symbols: str

Current price and trading data

get_summary_detail

symbols: str

Day range, volume, dividend, and 52-week range

get_historical_prices

symbols: str, period: str | None = None, start_date: str | None = None, end_date: str | None = None, interval: str = "1d"

Historical OHLCV price data

get_calendar_events

symbols: str

Upcoming earnings dates and dividend events

Financial Statements

Tool

Arguments

Returns

get_financial_data

symbols: str

Key financial data, including targets, margins, cash, debt, and growth

get_balance_sheet

symbols: str, frequency: str = "annual"

Balance sheet data

get_cash_flow

symbols: str, frequency: str = "annual"

Cash flow statement

get_income_statement

symbols: str, frequency: str = "annual"

Income statement

get_valuation_measures

symbols: str

Market cap, P/E, EV, and price/book measures

get_earnings

symbols: str

Earnings data

get_earnings_trend

symbols: str

Earnings trend estimates

Analysis & Research

Tool

Arguments

Returns

get_recommendations

symbols: str

Analyst recommendations

get_recommendation_trend

symbols: str

Strong buy, buy, hold, sell, and strong sell counts

get_technical_insights

symbols: str

Technical analysis insights

get_esg_scores

symbols: str

Environmental, social, and governance scores

get_company_profile

symbols: str

Company sector, industry, description, and address

Ownership & Governance

Tool

Arguments

Returns

get_major_holders

symbols: str

Major holders breakdown

get_institution_ownership

symbols: str

Institutional ownership

get_insider_holders

symbols: str

Insider holders

get_insider_transactions

symbols: str

Insider transactions

get_fund_ownership

symbols: str

Mutual fund and ETF ownership

get_company_officers

symbols: str

Executives, titles, and compensation

Discovery

Tool

Arguments

Returns

search_symbols

query: str

Matching stock symbols by company name or partial ticker

symbols is a comma-separated string, such as "AAPL,GOOGL,MSFT". Statement frequency accepts "annual" or "quarterly".

Development

Install development dependencies:

pip install -e ".[dev]"

Run the offline test suite and linter:

pytest
ruff check .

See CONTRIBUTING.md for the full contribution guide.

Data source

Data is sourced from Yahoo Finance through the unofficial yahooquery library. It is subject to Yahoo's terms and no API key is required.

License

MIT — see LICENSE.

Support

Please open a GitHub Issue.

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    A Model Context Protocol server providing real-time stock data and options analysis through Yahoo Finance, enabling LLMs to access market data, analyze stocks, and evaluate options strategies.
    Last updated
    25
    MIT
  • A
    license
    B
    quality
    B
    maintenance
    A Model Context Protocol server that enables interaction with Yahoo Finance to retrieve stock pricing, company information, and historical financial data through natural language queries.
    Last updated
    10
    27
    MIT
  • A
    license
    C
    quality
    -
    maintenance
    A Model Context Protocol server that provides tools for interacting with Yahoo Finance, allowing users to retrieve stock prices, company information, and perform financial data comparisons.
    Last updated
    11
  • A
    license
    -
    quality
    D
    maintenance
    Provides real-time financial data from Yahoo Finance to Large Language Models through the Model Context Protocol, enabling AI models to access stock prices, historical data, and company information.
    Last updated
    1
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chintan-diwakar/zentickr-yahoo-query-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server