Changelog¶
1.6.0¶
Added¶
MCP tools (3 new, 24 in total):
get_etf_profile(justETF): basics, overview, description, price, top holdings, countries and sectors of a European ETF by ISIN.get_quarterly_fundamentals(Digrin): long quarterly histories of assets vs liabilities, cash and debt, free cash flow, net income, revenue vs cost, expenses, shares outstanding and estimated EPS.get_option_expirations(Yahoo Finance): listed option expiration dates.
New datasets on existing tools:
get_analyst_estimates: Nasdaqearnings_surprise,quarterly_forecast,yearly_forecast,pe_forecastandgrowth_forecast.get_dividend_metrics: Finvizex_dividend_dates.get_earnings_reaction: FinvizannualEPS and sales since about 2010.get_margins_and_ratios: Macrotrendsrevenue_annualandrevenue_quarterly.get_pricesandget_splits:source="digrin"(monthly prices going back decades).get_financial_statement:statement="financials"(Yahoo Finance).get_company_profile:trading_hours.
Changed¶
justETF and Nasdaq methods use plain HTTP requests (justETF quote API, api.nasdaq.com JSON). Method names and return types are unchanged; the Nasdaq methods work again.
Removed¶
Selenium,
selenium_interface.pyand the bundled 15 MBchromedriver_linux64.
1.5.0¶
Added¶
MCP tools for Claude (5 new, 21 in total):
get_margins_and_ratios(Macrotrends): gross, operating, EBITDA, pre-tax and net margin history and key financial ratios.get_dividend_metrics(Digrin and Finviz): payout ratio, dividend growth projections, and annual dividend, yield and payout including estimates.get_revenue_breakdown(Finviz): annual revenue by segment, region or product.get_insider_trades(Finviz): recent insider buys and sales with price, shares and value.get_earnings_reaction(Finviz): price moves around earnings reports vs the S&P 500, EPS and revenue surprises, and estimate revisions.
get_financial_statementacceptssource="macrotrends"for about 15 years of statements. The default is still Yahoo Finance.MCP error codes
provider_blocked(the website refused the request) andlayout_changed(a scraped page changed).ProviderBlockedErrorandLayoutChangedErrorexceptions, raised by the scraped sources.TickerBase.forbidden_retriesandforbidden_retry_delayto tune the HTTP 403 retry loop.yahoo_api_company_name: the company’s full name from the Yahoo Finance API.
Deprecated¶
All
yahoo_web_*attributes, including theyahoo_web_financials_table(url, frequency)method. The Yahoo Finance website scraper has been removed because every dataset it returned is available from the Yahoo Finance API. The old names still work for now: each emits aDeprecationWarning, keeps its old security type check and returns the data from itsyahoo_api_*replacement, with the API’s column layout. They will be removed in 2.0.Deprecated
Replacement
yahoo_web_financials_table(url, frequency)yahoo_api_income_statement(),yahoo_api_balance_sheet()oryahoo_api_cash_flow(), picked from the URL (/financials,/balance-sheet,/cash-flow). Other URLs raiseValueError.yahoo_web_income_stmt,yahoo_web_balance_sheet,yahoo_web_cashflowyahoo_api_income_statement(),yahoo_api_balance_sheet(),yahoo_api_cash_flow()yahoo_web_calls,yahoo_web_putsyahoo_api_options_chain(option_type="calls" / "puts")yahoo_web_description,yahoo_web_corporate_governanceyahoo_api_profile()yahoo_web_key_executivesyahoo_api_officers()yahoo_web_major_holders,yahoo_web_top_institutional_holders,yahoo_web_top_mutual_fund_holdersyahoo_api_major_holders(),yahoo_api_institutional_holders(),yahoo_api_fund_holders()yahoo_web_summaryyahoo_api_market_price()andyahoo_api_summary_detail()yahoo_web_valuation_measuresyahoo_api_valuation_measures(), plusyahoo_api_valuation_measures(frequency="trailing")for the current values (the alias adds them as aCurrentrow)yahoo_web_financial_highlightsyahoo_api_financial_data(), plus the fiscal year end and most recent quarter fromyahoo_api_key_statistics()yahoo_web_trading_informationyahoo_api_key_statistics(), plus the 52-week range, averages and dividend fields fromyahoo_api_summary_detail()yahoo_web_earnings_estimate,yahoo_web_revenue_estimate,yahoo_web_eps_trend,yahoo_web_eps_revisions,yahoo_web_growth_estimatesyahoo_api_earnings_trend(). The S&P 500 benchmark row of the old growth estimates table is no longer available.yahoo_web_earnings_historyyahoo_api_earnings_history()yahoo_web_full_nameyahoo_api_company_name()
Fixed¶
The default
period1andperiod2of the Yahoo Finance API statement, valuation and plot methods are worked out on each call. Before, they were fixed when stockdex was imported, so a long-running process kept requesting the same date window.Macrotrends and Finviz cache downloaded pages per
Tickerinstead of in a class-widelru_cache, so long-running processes no longer keep every ticker and its pages in memory.Macrotrends parses its embedded data with
json.loadsinstead ofeval, so page content is never executed.Finviz methods return empty DataFrames instead of raising
IndexErrorwhen a list is empty, e.g.finviz_dividends_annual_datafor some tickers.finviz_overall_dividendno longer removes the dividend lists from the cached page data, sofinviz_dividends_date_dataworks after it.An HTTP 429 during the 403 retry loop is raised as
RateLimitError.Digrin tables and Macrotrends margin tables raise
LayoutChangedErrorwhen the rows no longer match the header, instead of returning an empty table. Finviz record lists with an unexpected shape are reported the same way.MCP errors keep the requested
source, e.g.macrotrendsorfinviz, even when the parameters are rejected.
Removed¶
The
stockdex.yahoo_web_interfacemodule and theYahooWebclass."yahoo_web"fromVALID_DATA_SOURCESand the unusedYAHOO_WEB_BASE_URLsetting.The “Yahoo Finance (Website)” docs page.
Changed¶
Macrotrends looks up the company name through the Yahoo Finance API instead of scraping the Yahoo website.
The Claude skill, plugin README, docs and Desktop extension describe the new tools and sources. justETF stays out of the MCP server because it needs a Chrome browser.
Docs: new landing page with install tabs and data-source cards, an API reference generated from the docstrings, a changelog page, a Finviz plots page, and the missing
justetf_price,justetf_holdings_countries,plot_dataframeandplot_finviz_*entries. The justETF page URL is nowjustetf_doc.html(wasjsutetf_doc.html).Docs are rebuilt and published on every merge to
main, and checked on pull requests that touch them. Sphinx warnings now fail the build.
1.4.0¶
Added¶
Yahoo Finance API:
yahoo_api_dividends,yahoo_api_splitsandyahoo_api_capital_gainsfrom the chart endpoint’s corporate-action events.Yahoo Finance API:
yahoo_api_valuation_measureswith market cap, enterprise value, P/E, forward P/E, PEG, P/S, P/B and EV ratios over time (annual, quarterly or trailing).Yahoo Finance API:
yahoo_api_quote_summary(modules)to fetch any quoteSummary module, plus methods built on it:company and market data:
yahoo_api_profile,yahoo_api_officers,yahoo_api_market_price,yahoo_api_summary_detail,yahoo_api_key_statistics,yahoo_api_financial_data,yahoo_api_calendar_eventsanalyst and earnings:
yahoo_api_earnings_history,yahoo_api_earnings_trend,yahoo_api_recommendation_trend,yahoo_api_upgrades_downgradesownership and filings:
yahoo_api_institutional_holders,yahoo_api_fund_holders,yahoo_api_major_holders,yahoo_api_insider_holders,yahoo_api_insider_transactions,yahoo_api_insider_purchase_activity,yahoo_api_sec_filingsETFs and mutual funds:
yahoo_api_fund_top_holdings,yahoo_api_fund_sector_weightings,yahoo_api_fund_asset_allocation,yahoo_api_fund_profile,yahoo_api_fund_performance
Yahoo Finance API:
yahoo_api_option_expirations,yahoo_api_options_chain,yahoo_api_quotes(many symbols in one request),yahoo_api_searchandyahoo_api_similar_symbols.MCP tools for Claude (13 new, 16 in total):
search_ticker,get_quotes,get_key_statistics,get_valuation_history,get_company_profile,get_analyst_estimates,get_earnings_calendar,get_holders,get_sec_filings,get_splits,get_options_chain,get_fund_holdingsandget_fund_profile, built on the Yahoo Finance API methods above.get_dividendsacceptssource="yahoo"orsource="auto"(Digrin with Yahoo Finance fallback). The default is still Digrin.
Changed¶
The Claude skill, plugin README, docs and Desktop extension description cover the new tools.
1.3.1¶
Changed¶
MCP tools now declare a
titleand full annotations (readOnlyHint,destructiveHint,idempotentHint,openWorldHint), and their descriptions state exactly what each tool returns and where the data comes from. This follows Anthropic’s Software Directory Policy.The Claude Code plugin moved to
plugins/stockdex/, with its own README and LICENSE, and pinsstockdex[mcp]==1.3.1exactly. The install commands stay the same.The Claude Desktop extension pins
stockdex[mcp]==1.3.1and adds a privacy disclosure and example prompts to its description.
1.3.0¶
Added¶
Local read-only MCP server (
stockdex-mcp, install withpip install "stockdex[mcp]") withget_prices,get_financial_statementandget_dividendstools.JSON command-line tool
stockdex-claudefor the same operations.Claude Code plugin and marketplace (
/plugin marketplace add ahnazary/stockdex).Claude Desktop extension
stockdex.mcpb, attached to GitHub releases.
Fixed¶
digrin_dividendraises a clearValueErrorwhen Digrin’s page layout changes, instead of anAttributeError. Rows that don’t match the table header are skipped.pip install -e .now works from a fresh clone without__version__.py.
Changed¶
Minimum Python version is now 3.9, matching the existing
pandas>=2.2.3requirement.
1.2.7¶
Fixed¶
Fixed
yahoo_api_financials(and related income statement, balance sheet, cash flow methods) dropping recent years’ data (2024, 2025) due to using the last column’s date index when constructing the DataFrame.
1.2.6¶
Fixed¶
yahoo_web_balance_sheet,yahoo_web_cashflow, andyahoo_web_income_stmtnow return all rows including expandable/hidden rows from Yahoo Finance by fetching data via the Yahoo timeseries API instead of only scraping the visible HTML rows.
1.0.8¶
Added¶
Added
macrotrends_revenuemethod to fetch quarterly and annual revenue data frommacrotrendswebsite.
1.0.5¶
Fixed¶
Fixed bug with selenium driver path.
1.0.4¶
Added¶
Added
justetf_pricemethod to fetch price data fromjustetfwebsite.fix bugs in
yahoo_webmodule.
1.0.2¶
Added¶
Added
ruffas link to the project.
Fixed¶
Fix path to chrome driver in selenium module.
Fix yahoo web financials, balance sheet, and cash flow data.
Changed¶
1.0.0¶
Added¶
Added
plotlyanddashmodules to plot financial data and create dash app.
Fixed¶
Changed¶
0.7.0¶
Added¶
Added following properties to yahoo web module:
yahoo_web_earnings_estimateyahoo_web_revenue_estimateyahoo_web_earnings_historyyahoo_web_eps_trendyahoo_web_eps_revisionsyahoo_web_growth_estimates
Fixed¶
Changed¶
0.6.0¶
Added¶
Module for
´macrotrendswebsite to fetch data.methods for extracting basic and margin related data from
macrotrendswebsite.
Fixed¶
Changed¶
Some log messages are changed.
TickerFactoryclass is removed andTickerclass is used to createTickerobjects.Tickerclass now is the main calss andTickerFactoryclass is removed.
0.5.0¶
Added¶
– data_source in the TickerFactory class to specify the source of the data.
– WrongSecurityType exception class to raise an exception when the security type is not valid.
Fixed¶
Bug with
isinfield in all classes.
Changed¶
Removed
nasdaqmodule as the website keeps changing its structure.Instead of
Tickerclass,TickerFactoryclass is used to createTickerobjects.
0.4.0¶
Added¶
More methods for fetching data from
NASDAQwebsite.More methods for fetching data from
JustETFwebsite.Separate module for yahoo finance web related functions.
Fixed¶
Bug with
security_typefield in all classes.
Changed¶
Tickerclass now acceptsisinandsecurity_typeas arguments.