Zentickr

You can access and query Yahoo Finance data programmatically through Zentickr, a Model Context Protocol (MCP) server that exposes real-time prices, financial statements, company profiles, historical data, and analytics. You connect with MCP-compatible clients to retrieve market data and insights for building AI-assisted financial tools, dashboards, or research workflows while benefiting from asynchronous processing and transparent data sourcing.

How to use

You run Zentickr as an MCP server and connect using a compatible MCP client. The server provides a wide range of financial data endpoints, including real-time prices, historical prices, company profiles, earnings, valuation metrics, ESG scores, and market events. Use the client to request data for specific symbols or groups of symbols, and integrate the results into your AI workflows, dashboards, or analysis pipelines.

How to install

Prerequisites you need to have before installing Zentickr include Python 3.10 or higher and the pip package manager.

# Step 1: Clone the repository
git clone <your-repository-url>
cd Zentickr

# Step 2: Create and activate a virtual environment
python -m venv env
source env/bin/activate  # On Windows: env\Scripts\activate

# Step 3: Install dependencies
pip install -r requirements.txt

# Step 4: Run the server using the provided script
# Option 1: Using the run scripts (Recommended)
./run_server.sh            # Unix-like systems
.\run_server.bat           # Windows

# Option 2: Manual execution
python run_server.py

Additional sections

Configuration and startup options are designed to be straightforward. Zentickr runs via a local, standard input/output (stdio) interface, allowing you to start the server directly from your development environment or integration tool. The recommended way is to invoke the run script which activates the appropriate virtual environment and launches the server.

Security and rate limiting: Zentickr respects Yahoo Finance data usage policies and processes data asynchronously for performance. No API keys are required for access since the server uses public Yahoo Finance endpoints. Always ensure you comply with data usage terms and monitor for any data limitations.

Connecting clients and configuration: Zentickr exposes its MCP interface via standard input/output. You can initiate the server from your environment using a Python invocation that points to the main entry point script. If you prefer, you can use the provided startup scripts to simplify environment activation and execution.

Troubleshooting tips: If the server does not start, verify that Python 3.10+ is installed, the virtual environment is activated, and dependencies are installed. Check for common port or I/O conflicts in your development environment and ensure you are using the exact start command shown in the startup snippet.

Available tools

get_financial_data

Retrieve current financial data for one or more stock symbols, including core metrics and key indicators.

get_price_data

Fetch current stock prices and related price data for selected symbols.

search_symbols

Search for stock symbols by company name or partial ticker to locate relevant equities.

get_income_statement

Obtain quarterly or annual income statements for a given company.

get_balance_sheet

Retrieve balance sheet data for a company over the requested period.

get_cash_flow

Access cash flow statements showing operating, investing, and financing activities.

get_company_profile

Get detailed company profiles including business description and headquarters.

get_company_officers

Fetch information about key executives and officers of a company.

get_valuation_measures

Access valuation metrics such as market cap, P/E, price-to-book, and price-to-sales.

get_recommendations

Obtain analyst recommendations and target prices for a symbol.

get_earnings

Retrieve earnings data and trends for specified periods.

get_earnings_trend

Analyze earnings trends over time to gauge performance trajectory.

get_institution_ownership

Access institutional ownership data and major holders.

get_esg_scores

Fetch Environmental, Social, and Governance scores for a company.

get_calendar_events

Get upcoming earnings dates and other corporate events.