Connects AI agents to real-time and historical financial intelligence, SEC filings, macroeconomic data, and quantitative portfolio analytics.
Also known as danchev/openmarkets, openmarkets
- Stars
- 7
- Tools
- 127
- Downloads, 30 days
- 622
- Latest version
- 0.1.0b1
- Last commit
- Nov 13, 2026
- License
- AGPL-3.0
What is Open Markets MCP?
Open Markets connects AI agents to real-time and historical financial intelligence, SEC filings, macroeconomic data, and quantitative portfolio analytics. It exposes 127 tools, such as get_analyst_recommendations, get_earnings_estimates, get_eps_trends.
Summary generated from the project's README
About Open Markets MCP server
Open Markets provides a comprehensive bridge between AI agents and institutional-grade financial intelligence. It aggregates data from multiple providers to deliver real-time and historical insights across equities, fixed income, commodities, currencies, derivatives, and cryptocurrency. Developers can use this server to equip LLM agents with the ability to perform complex market analysis, retrieve SEC regulatory filings, and access macroeconomic telemetry from sources like the Federal Reserve Economic Data engine.
The server is designed for local integration with clients such as Claude Desktop, Cursor, VS Code, and Cline using the Model Context Protocol. It can be installed via uvx or added as a plugin to Claude Code. Users can customize the toolset by selecting specific domain profiles, such as equities, macro, quant, or sec, to limit the 127 available tools to a relevant subset. This architecture allows for specialized agent behaviors ranging from simple stock lookups to advanced quantitative portfolio risk analytics and backtesting.
What you can do with it
- 1Analyze regulatory filingsAn agent can retrieve official SEC EDGAR submissions including 10-K annual reports and 8-K material events.
- 2Perform technical market analysisA developer can task an AI with calculating momentum indicators like RSI or MACD using intraday tick data.
- 3Evaluate portfolio riskAn AI client can calculate complex risk metrics such as Value-at-Risk or Sharpe ratios for multi-asset portfolios.
- 4Monitor macroeconomic trendsAgents can track critical economic indicators like CPI inflation, unemployment rates, and GDP growth.
Written from the project's README. Every use case is checked against a quote from it.
How to install Open Markets MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Open Markets MCP in Claude Code
$ claude mcp add openmarkets -- uvx openmarketsInstall Open Markets MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"openmarkets": {
"command": "uvx",
"args": [
"openmarkets"
]
}
}
}Install Open Markets MCP in VS Code
.vscode/mcp.json
{
"servers": {
"openmarkets": {
"type": "stdio",
"command": "uvx",
"args": [
"openmarkets"
]
}
}
}Install Open Markets MCP in VS Code CLI
$ code --add-mcp '{"name":"openmarkets","type":"stdio","command":"uvx","args":["openmarkets"]}'Install Open Markets MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"openmarkets": {
"command": "uvx",
"args": [
"openmarkets"
]
}
}
}Install Open Markets MCP in Codex
$ codex mcp add openmarkets -- uvx openmarketsInstall Open Markets MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.openmarkets] command = "uvx" args = ["openmarkets"]
Install Open Markets MCP in Gemini CLI
$ gemini mcp add -s user openmarkets uvx -- openmarketsInstall Open Markets MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"openmarkets": {
"command": "uvx",
"args": [
"openmarkets"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for openmarkets 0.1.0b1 in an isolated container with no network and no keys. It answered and listed 127 tools.
Open Markets MCP tools 127
Read from the server with tools/listget_analyst_recommendationsRead-onlyRetrieve analyst recommendations for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: Analyst recommendations data from the repository.
get_earnings_estimatesRead-onlyRetrieve earnings estimates for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: Earnings estimates data from the repository.
get_eps_trendsRead-onlyRetrieve EPS (Earnings Per Share) trends for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: EPS trends data from the repository.
get_full_analysisRead-onlyRetrieve a full analysis report for a given ticker, aggregating all available analysis data. Args: ticker (str): The symbol of the security. Returns: FullAnalysis: All analysis data for the ticker.
get_growth_estimatesRead-onlyRetrieve growth estimates for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: Growth estimates data from the repository.
get_price_targetsRead-onlyRetrieve price targets for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: Price targets data from the repository.
get_recommendation_changesRead-onlyRetrieve changes in analyst recommendations for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: Recommendation changes data from the repository.
get_revenue_estimatesRead-onlyRetrieve revenue estimates for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: Revenue estimates data from the repository.
get_agriculture_pricesRead-onlyRetrieve current prices for major agricultural grains (Wheat, Corn, Soybeans, Coffee, Sugar).
get_commodity_historyRead-onlyRetrieve historical price timeseries for a physical commodity or future.
get_commodity_quoteRead-onlyRetrieve the latest price quote for a physical commodity or futures contract.
get_energy_pricesRead-onlyRetrieve current prices for benchmark energy commodities (WTI Crude, Brent, Natural Gas, Gasoline, Heating Oil).
Show all 127 toolsShow fewer tools
get_fertilizer_price_indexRead-onlyRetrieve Green Markets North American Fertilizer Price Index timeseries. Benchmark weekly index published by Green Markets / Bloomberg / Dow Jones tracking raw agricultural input costs. Returns: FertilizerIndexSeries with latest price index and historical observations.
get_livestock_pricesRead-onlyRetrieve current snapshot prices for livestock commodities (Live Cattle, Feeder Cattle, Lean Hogs).
get_metals_pricesRead-onlyRetrieve current prices for precious and industrial metals (Gold, Silver, Copper, Platinum, Palladium).
get_softs_pricesRead-onlyRetrieve current snapshot prices for soft commodities (Coffee, Sugar, Cocoa, Cotton).
get_crypto_fear_greed_proxyRead-onlyRetrieve a proxy value for the crypto fear and greed index. Args: tickers (list[str] | None, optional): List of crypto tickers to include. If None, uses a default set. Returns: CryptoSentiment: Sentiment proxy and supporting per-asset data.
get_crypto_historyRead-onlyRetrieve historical price data for a cryptocurrency. Args: ticker (str): The symbol of the cryptocurrency. period (str, optional): Time period for history. Valid periods: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max. Defaults to '1y'. interval (str, optional): Data interval. Valid intervals: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo. Defaults to '1d'. Returns: list[CryptoHistory]: List of historical data points.
get_crypto_infoRead-onlyRetrieve fast information for a specific cryptocurrency. Args: ticker (str): The symbol of the cryptocurrency (e.g., 'BTC'). Returns: CryptoFastInfo: Fast info data for the given ticker.
get_top_cryptocurrenciesRead-onlyRetrieve quotes for the configured major-cryptocurrency watchlist. Args: count (int, optional): Number of top cryptocurrencies to fetch. Defaults to 10. Returns: list[CryptoFastInfo]: List of top cryptocurrencies.
get_balance_sheetRead-onlyRetrieve the balance sheet for a given ticker. Args: ticker (str): The symbol of the security. Returns: list[BalanceSheetEntry]: List of balance sheet entries.
get_curated_financialsRead-onlyRetrieve curated essential financial performance and solvency snapshot (15 metrics). Optimized for LLM reasoning to avoid context window bloat. Args: ticker (str): The symbol of the security. Returns: CuratedFinancialSummary: Core financial metrics for fundamental analysis.
get_eps_historyRead-onlyRetrieve EPS (Earnings Per Share) history for a given ticker. Args: ticker (str): The symbol of the security. Returns: list[EPSHistoryEntry]: List of EPS history entries.
get_financial_calendarRead-onlyRetrieve the financial calendar for a given ticker. Args: ticker (str): The symbol of the security. Returns: FinancialCalendar: Financial calendar data.
get_full_financialsRead-onlyRetrieve a full set of financial data for a given ticker, aggregating all available financial statements and records. Args: ticker (str): The symbol of the security. Returns: FullFinancials: All financial data for the ticker.
get_income_statementRead-onlyRetrieve the income statement for a given ticker. Args: ticker (str): The symbol of the security. Returns: list[IncomeStatementEntry]: List of income statement entries.
get_sec_filingsRead-onlyRetrieve SEC filings for a given ticker. Args: ticker (str): The symbol of the security. Returns: list[SecFilingRecord]: List of SEC filing records.
get_ttm_cash_flow_statementRead-onlyRetrieve the trailing twelve months (TTM) cash flow statement for a given ticker. Args: ticker (str): The symbol of the security. Returns: list[TTMCashFlowStatementEntry]: List of TTM cash flow statement entries.
get_ttm_income_statementRead-onlyRetrieve the trailing twelve months (TTM) income statement for a given ticker. Args: ticker (str): The symbol of the security. Returns: list[TTMIncomeStatementEntry]: List of TTM income statement entries.
get_global_sovereign_yieldsRead-onlyRetrieve benchmark 10-year sovereign bond yields across major global economies. Compares benchmark 10-year government bond yields for the United States, Germany (Bund), United Kingdom (Gilt), and Japan (JGB), including calculated spreads against the US 10-Year Treasury. Returns: Snapshot of global 10-year sovereign benchmark yields and yield differentials.
get_treasury_yield_curveRead-onlyRetrieve the complete US Treasury yield curve snapshot across all benchmark maturities (1M to 30Y). Includes calculated 2Y/10Y and 3M/10Y basis point spreads and yield curve inversion status.
get_treasury_yield_historyRead-onlyRetrieve historical yield timeseries for a specific Treasury or sovereign benchmark maturity.
get_dollar_index_dxyRead-onlyFetch current US Dollar Index (DXY) quote. The US Dollar Index measures the value of the US dollar relative to a basket of major foreign currencies. Returns: Current DXY index quote.
get_forex_historyRead-onlyFetch historical timeseries exchange rate bars for a currency pair. Args: pair: Currency pair symbol (e.g. ``EURUSD``, ``USDJPY``). timeframe: Timespan duration (e.g. ``D7``, ``P1M``, ``P3M``, ``P1Y``, ``P5Y``, ``all``). step: Bar step frequency (e.g. ``P1D``, ``PT1M``). Returns: Historical OHLC exchange rate bars.
get_forex_quoteRead-onlyFetch current or latest foreign exchange quote for a currency pair. Args: pair: Currency pair symbol (e.g. ``EURUSD``, ``USDJPY``, ``GBPUSD``, ``AUDUSD``, ``USDCAD``, ``USDCHF``). Returns: Real-time or latest exchange rate with timestamp and currency breakdown.
get_major_currenciesRead-onlyFetch real-time snapshot quotes for all major global currency pairs. Covers EUR/USD, USD/JPY, GBP/USD, AUD/USD, USD/CAD, USD/CHF, USD/CNY, USD/MXN, and USD/INR. Returns: List of major currency pair quotes.
get_fund_asset_class_holdingsRead-onlyRetrieve asset class holdings for a specific fund. Args: ticker (str): The symbol of the fund. Returns: FundAssetClassHolding | None: Asset class holdings data or None if unavailable.
get_fund_bond_holdingsRead-onlyRetrieve the bond holdings for a specific fund. Args: ticker (str): The symbol of the fund. Returns: list[FundBondHolding]: List of bond holdings in the fund.
get_fund_equity_holdingsRead-onlyRetrieve the equity holdings for a specific fund. Args: ticker (str): The symbol of the fund. Returns: list[FundEquityHolding]: List of equity holdings in the fund.
get_fund_infoRead-onlyRetrieve general information for a specific fund. Args: ticker (str): The symbol of the fund. Returns: FundInfo: Information about the fund.
get_fund_operationsRead-onlyRetrieve operations data for a specific fund. Args: ticker (str): The symbol of the fund. Returns: FundOperations | None: Operations data or None if unavailable.
get_fund_overviewRead-onlyRetrieve an overview for a specific fund. Args: ticker (str): The symbol of the fund. Returns: FundOverview | None: Overview data or None if unavailable.
get_fund_sector_weightingRead-onlyRetrieve sector weighting data for a specific fund. Args: ticker (str): The symbol of the fund. Returns: FundSectorWeighting | None: Sector weighting data or None if unavailable.
get_fund_top_holdingsRead-onlyRetrieve the top holdings for a specific fund. Args: ticker (str): The symbol of the fund. Returns: list[FundTopHolding]: List of top holdings in the fund.
get_full_holdingsRead-onlyRetrieve a full set of holdings data for a given ticker, aggregating all available holdings information. Args: ticker (str): The symbol of the security. Returns: FullHoldings: All holdings data for the ticker.
get_insider_purchasesRead-onlyRetrieve insider purchases for a given ticker. Args: ticker (str): The symbol of the security. Returns: list[InsiderPurchase]: Insider purchase activity.
get_insider_roster_holdersRead-onlyRetrieve the insider roster for a given ticker. Args: ticker (str): The symbol of the security. Returns: list[InsiderRosterHolder]: Insiders and their holdings.
get_institutional_holdingsRead-onlyRetrieve institutional holdings for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: Institutional holdings data from the repository.
get_major_holdersRead-onlyRetrieve major holders for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: Major holders data from the repository.
get_mutual_fund_holdingsRead-onlyRetrieve mutual fund holdings for a given ticker. Args: ticker (str): The symbol of the security. Returns: Any: Mutual fund holdings data from the repository.
get_cpi_inflationRead-onlyRetrieve US Consumer Price Index (CPI) and Core CPI with year-over-year inflation rates. Args: limit: Number of recent monthly observations to include (default 24). Returns: InflationSummary containing Headline CPI, Core CPI, and YoY percentage inflation.
get_employment_indicatorsRead-onlyRetrieve US labor market telemetry including Civilian Unemployment Rate and Nonfarm Payrolls. Args: limit: Number of recent monthly observations to include (default 24). Returns: EmploymentSummary with unemployment rate %, total payrolls, and monthly net job creation.
get_financial_stress_and_credit_spreadsRead-onlyRetrieve St. Louis Fed Financial Stress Index and ICE BofA US High Yield OAS credit spreads. Args: limit: Number of recent observations to include (default 30). Returns: FinancialStressSummary containing stress index level, market condition interpretation, and high-yield spreads.
get_gdp_growthRead-onlyRetrieve US Real GDP and Nominal GDP output levels with quarter-over-quarter annualized growth rates. Args: limit: Number of recent quarterly observations to include (default 20). Returns: GDPSummary with Real GDP, Nominal GDP, and annualized real economic growth rate.
get_inflation_expectationsRead-onlyRetrieve 5-Year and 10-Year market-implied Breakeven Inflation Rates from TIPS. Args: limit: Number of recent daily observations to include (default 30). Returns: InflationExpectationsSummary with 5Y and 10Y breakeven inflation rates (%).
get_interest_rates_telemetryRead-onlyRetrieve benchmark US money market and monetary policy interest rates (EFFR and SOFR). Args: limit: Number of recent daily observations to include (default 30). Returns: InterestRatesSummary with Effective Federal Funds Rate (EFFR) and SOFR rates.
get_macroeconomic_seriesRead-onlyQuery historical observations and metadata for any valid Federal Reserve Economic Data (FRED) series identifier. Examples: 'MORTGAGE30US' (30-Year Fixed Mortgage Rate), 'UMCSENT' (Consumer Sentiment), 'INDPRO' (Industrial Production). Args: series_id: Valid FRED series identifier (e.g. 'CPIAUCSL', 'MORTGAGE30US', 'INDPRO'). limit: Number of recent observations to return (default 50, 0 for all available). Returns: MacroeconomicSeries with series title, units, frequency, latest release, and data points.
get_money_supply_and_fed_balance_sheetRead-onlyRetrieve US M2 Money Supply and Federal Reserve Balance Sheet (Total Assets) liquidity telemetry. Args: limit: Number of recent observations to include (default 24). Returns: LiquiditySummary containing M2 Money Supply ($B), M2 YoY growth, and Fed Balance Sheet ($M).
get_pce_inflationRead-onlyRetrieve US Core Personal Consumption Expenditures (PCE) Price Index (Fed's primary inflation target). Args: limit: Number of recent monthly observations to include (default 24). Returns: PCESummary containing latest Core PCE level, YoY inflation rate, and Fed 2% target reference.
get_global_indicesRead-onlyRetrieve real-time snapshot of major global equity benchmark indices. Includes US (S&P 500, Dow Jones, Nasdaq, Russell 2000), Europe (DAX 40, FTSE 100, CAC 40, Euro Stoxx 50), and Asia (Nikkei 225, Hang Seng) alongside CBOE VIX. Returns: GlobalMarketSnapshot with all international benchmark quotes.
get_market_statusRead-onlyRetrieve the current status of major market indices. Returns: dict: Market indices status data.
get_market_summaryRead-onlyRetrieve a summary of the overall market performance. Returns: dict: Market summary data.
get_volatility_vixRead-onlyRetrieve real-time quote for the CBOE Volatility Index (VIX / Wall Street Fear Gauge). Returns: GlobalIndexQuote with latest VIX index value and date.
get_call_optionsRead-onlyRetrieve call options for a given ticker and expiration date. Args: ticker (str): The symbol of the security. expiration (date | None, optional): The expiration date. If None, uses the nearest expiration. Returns: list[CallOption] | None: List of call options or None if unavailable.
get_option_chainRead-onlyRetrieve the option contract chain for a given ticker and expiration date. Args: ticker (str): The symbol of the security. expiration (date | None, optional): The expiration date. If None, uses the nearest expiration. Returns: OptionContractChain: The option contract chain data.
get_option_expiration_datesRead-onlyRetrieve available option expiration dates for a given ticker. Args: ticker (str): The symbol of the security. Returns: list[OptionExpirationDate]: List of available expiration dates.
get_options_by_moneynessRead-onlyRetrieve options filtered by moneyness for a given ticker and expiration date. Args: ticker (str): The symbol of the security. expiration_date (str | None, optional): The expiration date as a string. If None, uses the nearest expiration. moneyness_range (float, optional): The moneyness range for filtering. Defaults to 0.1. Returns: dict: Options data filtered by moneyness.
get_options_skewRead-onlyRetrieve options skew analysis for a given ticker and expiration date. Args: ticker (str): The symbol of the security. expiration_date (str | None, optional): The expiration date as a string. If None, uses the nearest expiration. Returns: dict: Options skew analysis data.
get_options_volume_analysisRead-onlyRetrieve options volume analysis for a given ticker and expiration date. Args: ticker (str): The symbol of the security. expiration_date (str | None, optional): The expiration date as a string. If None, uses the nearest expiration. Returns: dict: Volume analysis data.
get_put_optionsRead-onlyRetrieve put options for a given ticker and expiration date. Args: ticker (str): The symbol of the security. expiration (date | None, optional): The expiration date. If None, uses the nearest expiration. Returns: list[PutOption] | None: List of put options or None if unavailable.
backtest_mean_reversion_strategyRead-onlyExecute Relative Strength Index (RSI) Mean-Reversion strategy backtest. Enters long when RSI drops below oversold threshold; exits to cash when RSI reaches overbought threshold. Evaluates trade win rate, profit factor, max drawdown, and equity progression. Args: ticker: Asset ticker. rsi_window: RSI calculation window in days. oversold_threshold: RSI buy trigger level. overbought_threshold: RSI sell trigger level. period: Backtest timespan. initial_capital: Starting capital in USD. slippage_bps: Slippage charged per entry or exit, in basis points. Returns: BacktestResult with performance metrics and closed trades.
backtest_trend_following_strategyRead-onlyExecute Moving Average Crossover (Golden Cross / Death Cross) rule-based strategy backtest. Enters long position when fast MA crosses above slow MA; exits to cash when fast MA crosses below slow MA. Calculates cumulative return, CAGR, benchmark buy & hold comparison, win rate, profit factor, and equity curve. Args: ticker: Asset ticker. fast_window: Fast SMA period in days. slow_window: Slow SMA period in days. period: Backtest timespan. initial_capital: Starting capital in USD. slippage_bps: Slippage charged per entry or exit, in basis points. Returns: BacktestResult with complete trade log and performance statistics.
calculate_asset_correlation_matrixRead-onlyCalculate pairwise correlation matrix and annualized covariance matrix across a basket of assets. Evaluates diversification benefits and cross-asset correlations (-1.0 to +1.0) across equities, ETFs, crypto, commodities, and fixed income. Args: tickers: Asset symbols to compare. period: Lookback timespan. Returns: CorrelationMatrixResult with correlation and covariance matrices.
calculate_drawdown_seriesRead-onlyCalculate historical underwater drawdown curve and maximum peak-to-trough decline series. Evaluates historical capital drawdown depths and recovery timelines from previous peaks. Args: tickers: Portfolio asset tickers. weights: Portfolio weights. period: Lookback duration. Returns: DrawdownSeriesResult with underwater percentage drawdown points.
calculate_factor_exposuresRead-onlyCalculate multi-factor linear regression exposures against benchmark macro market drivers. Regresses asset returns against Market (SPY), Tech Growth (QQQ), Small-Cap (IWM), Treasuries (TLT), and Gold (GLD) to estimate systematic factor loadings, Jensen's Alpha, and R-squared. Args: ticker: Asset ticker. period: Lookback timespan. Returns: FactorExposuresResult with estimated factor betas and model statistics.
calculate_minimum_variance_portfolioRead-onlyCalculate Markowitz numerical Minimum Variance portfolio allocation weights. Solves for long-only asset weights that minimize overall portfolio variance using the empirical covariance matrix. Args: tickers: Asset symbols. period: Lookback duration for covariance estimation. Returns: PortfolioAllocationResult with minimum variance asset weights.
calculate_portfolio_risk_metricsRead-onlyCalculate comprehensive quantitative risk and performance metrics for a multi-asset portfolio. Computes Annualized Return, Annualized Volatility, Sharpe Ratio, Sortino Ratio, Calmar Ratio, Max Drawdown, 1-Day Historical Value-at-Risk (VaR 95% & 99%), Expected Shortfall (CVaR 95% & 99%), Beta, and Jensen's Alpha against a benchmark. Assumes frictionless daily rebalancing to the supplied target weights, using the assets' common price history. Args: tickers: Asset ticker symbols. weights: Portfolio weights. benchmark: Benchmark symbol. period: Lookback duration. risk_free_rate: Risk-free rate. Returns: PortfolioRiskMetrics object with risk-adjusted performance breakdown.
calculate_risk_parity_weightsRead-onlyCalculate equal-risk-contribution risk parity allocation weights. Allocates capital inversely proportional to historical volatility so each asset reports each asset's actual covariance-based contribution to portfolio risk. Args: tickers: Asset symbols to allocate. period: Historical volatility lookback duration. Returns: PortfolioAllocationResult with recommended percentage weights.
calculate_rolling_betaRead-onlyCalculate historical rolling window Beta sensitivity series against a benchmark. Reveals how an asset's market correlation and systematic risk exposure have evolved over time. Args: ticker: Asset symbol. benchmark: Benchmark symbol. window: Rolling window length in days. period: Lookback duration. Returns: RollingBetaSeries with chronological rolling beta values.
search_screener_matchesRead-onlyRun a predefined screener query to discover matching equities, ETFs or mutual funds - for example the current day's top gainers, the most actively traded stocks, or top-performing ETFs. Args: query (str): Name of a predefined screen. One of: aggressive_small_caps, bond_etfs, conservative_foreign_funds, day_gainers, day_losers, growth_technology_stocks, high_yield_bond, most_actives, most_shorted_stocks, portfolio_anchors, small_cap_gainers, solid_large_growth_funds, solid_midcap_growth_funds, technology_etfs, top_etfs_us, top_mutual_funds, top_performing_etfs, undervalued_growth_stocks, undervalued_large_caps. count (int, optional): Maximum number of results to return. Defaults to 25. Must be positive; Yahoo caps this at 250. offset (int, optional): Number of results to skip, for pagination. Defaults to 0. Must be non-negative. Returns: ScreenerResult: Matching instruments and the total match count. Raises: ValueError: If query is unknown, or count/offset is out of range.
get_sec_10k_annual_filingsRead-onlyRetrieve annual Form 10-K regulatory filings with direct document links. Annual reports filed with the SEC containing audited balance sheets, income statements, MD&A discussion, and comprehensive risk factor disclosures. Args: ticker: Stock ticker symbol. limit: Number of annual 10-K filings to retrieve. Returns: List of Form 10-K filing items with direct SEC document URLs.
get_sec_10q_quarterly_filingsRead-onlyRetrieve quarterly Form 10-Q regulatory filings with direct document links. Quarterly reports filed with the SEC containing unaudited financial statements and ongoing quarterly operations review. Args: ticker: Stock ticker symbol. limit: Number of quarterly 10-Q filings to retrieve. Returns: List of Form 10-Q filing items with direct SEC document URLs.
get_sec_8k_material_eventsRead-onlyRetrieve Form 8-K unscheduled material corporate event announcements. Covers major corporate events including quarterly earnings press releases, executive appointments/departures, M&A transactions, debt financings, and material agreements. Args: ticker: Stock ticker symbol. limit: Number of Form 8-K filings to retrieve. Returns: List of Form 8-K material event filings with direct SEC document URLs.
get_sec_cik_lookupRead-onlySearch the official SEC registered company directory by ticker or company name. Resolves ticker symbols and company titles to their official 10-digit Central Index Key (CIK). Args: query: Ticker or company title search string. limit: Maximum number of matches to return. Returns: List of SECCIKLookupResult matches.
get_sec_company_profileRead-onlyRetrieve official SEC corporate registrant profile and metadata. Includes 10-digit CIK, Standard Industrial Classification (SIC) code, business/mailing address, fiscal year end, and state of incorporation directly from SEC EDGAR. Args: ticker: Stock ticker symbol or CIK. Returns: SECCompanyProfile with regulatory corporate metadata.
get_sec_insider_form4_filingsRead-onlyRetrieve Form 4 insider ownership changes and transaction filings. Filed by corporate officers, directors, and 10%+ beneficial owners reporting open-market stock purchases, sales, option exercises, and restricted stock grants. Args: ticker: Stock ticker symbol. limit: Number of Form 4 filings to retrieve. Returns: List of Form 4 insider filings with direct SEC document URLs.
get_sec_recent_filingsRead-onlyRetrieve recent regulatory filings submitted to the SEC by a company. Provides direct SEC EDGAR document URLs, acceptance dates, accession numbers, and XBRL flags. Args: ticker: Stock ticker symbol. form_type: Optional filter by SEC Form (e.g. '10-K', '10-Q', '8-K', '4'). limit: Maximum number of filing records to return. Returns: List of SECFilingItem objects with direct HTTPS document URLs.
get_sec_xbrl_company_factsRead-onlyRetrieve catalog summary of all interactive US-GAAP XBRL financial disclosure concepts for an entity. Provides a count and sample of available standard US-GAAP accounting tags filed in the registrant's XBRL facts. Args: ticker: Stock ticker symbol. Returns: SECXBRLCompanyFactsSummary with taxonomy metrics overview.
get_sec_xbrl_concept_timeseriesRead-onlyRetrieve historical timeseries for a specific US-GAAP XBRL accounting concept directly from SEC filings. Extracts exact financial values, units, fiscal years, and fiscal periods filed in official 10-K and 10-Q reports. Args: ticker: Stock ticker symbol. concept: US-GAAP tag or alias ('REVENUES', 'NET_INCOME', 'GROSS_PROFIT', 'ASSETS', 'CASH', 'EPS'). limit: Maximum historical observation periods to return. Returns: SECXBRLConceptTimeseries with historical reported values.
get_all_industriesRead-onlyRetrieve a list of all industries, optionally filtered by sector. Backed by a static local mapping rather than a region-scoped upstream call, so this tool takes no region parameter. Args: sector (str | None): The name of the sector to filter by, or None to retrieve all industries. Returns: list[str]: A list of all industries, or industries in the specified sector.
get_industry_overviewRead-onlyRetrieve an overview of a specific industry. Args: industry (str): The name of the industry. region (str): ISO 3166-1 alpha-2 country code. Defaults to 'US'. Accepted for a consistent signature; has no observable effect on this endpoint upstream. Returns: IndustryOverview: An overview of the specified industry.
get_industry_top_companiesRead-onlyRetrieve a list of top companies within a specific industry. Args: industry (str): The name of the industry. region (str): ISO 3166-1 alpha-2 country code scoping the returned companies to that region's exchange. Defaults to 'US'. Returns: list[IndustryTopCompaniesEntry]: A list of top companies in the industry.
get_industry_top_growth_companiesRead-onlyRetrieve a list of top growth companies within a specific industry. Args: industry (str): The name of the industry. region (str): ISO 3166-1 alpha-2 country code scoping the returned companies to that region's exchange. Defaults to 'US'. Returns: list[IndustryTopGrowthCompaniesEntry]: A list of top growth companies in the industry.
get_industry_top_performing_companiesRead-onlyRetrieve a list of top performing companies within a specific industry. Args: industry (str): The name of the industry. region (str): ISO 3166-1 alpha-2 country code scoping the returned companies to that region's exchange. Defaults to 'US'. Returns: list[IndustryTopPerformingCompaniesEntry]: A list of top growth companies in the industry.
get_sector_industriesRead-onlyRetrieve a list of industries within a specific sector. Backed by a static local mapping rather than a region-scoped upstream call, so this tool takes no region parameter. Args: sector (str): The name of the sector. Returns: list[str]: A list of industries in the sector.
get_sector_overviewRead-onlyRetrieve overview information for a specific sector. Args: sector (str): The name of the sector. region (str): ISO 3166-1 alpha-2 country code. Defaults to 'US'. Accepted for a consistent signature; has no observable effect on this endpoint upstream (overview data does not vary by region). Returns: SectorOverview: Overview data for the sector.
get_sector_overview_for_tickerRead-onlyRetrieve overview information for a specific sector based on a stock ticker. Args: ticker (str): The stock ticker symbol. region (str): ISO 3166-1 alpha-2 country code. Defaults to 'US'. Accepted for a consistent signature; has no observable effect on this endpoint upstream (overview data does not vary by region). Returns: SectorOverview: Overview data for the sector associated with the ticker.
get_sector_research_reportsRead-onlyRetrieve a list of research reports within a specific sector. Args: sector (str): The name of the sector. region (str): ISO 3166-1 alpha-2 country code. Defaults to 'US'. Accepted for a consistent signature; has no observable effect on this endpoint upstream. Returns: list[IndustryResearchReportEntry]: A list of research reports in the sector.
get_sector_top_companiesRead-onlyRetrieve a list of top companies within a specific sector. Args: sector (str): The name of the sector. region (str): ISO 3166-1 alpha-2 country code scoping the returned companies to that region's exchange. Defaults to 'US'. Returns: list[SectorTopCompaniesEntry]: A list of top companies in the sector.
get_sector_top_companies_for_tickerRead-onlyRetrieve a list of top companies within a specific sector based on a stock ticker. Args: ticker (str): The stock ticker symbol. region (str): ISO 3166-1 alpha-2 country code scoping the returned companies to that region's exchange. Defaults to 'US'. Returns: list[SectorTopCompaniesEntry]: A list of top companies in the sector associated with the ticker.
get_sector_top_etfsRead-onlyRetrieve a list of top ETFs within a specific sector. Args: sector (str): The name of the sector. region (str): ISO 3166-1 alpha-2 country code. Defaults to 'US'. Any non-US region returns an empty list upstream rather than region-specific ETFs. Returns: list[SectorTopETFsEntry]: A list of top ETFs in the sector.
get_sector_top_mutual_fundsRead-onlyRetrieve a list of top mutual funds within a specific sector. Args: sector (str): The name of the sector. region (str): ISO 3166-1 alpha-2 country code. Defaults to 'US'. Any non-US region returns an empty list upstream rather than region-specific funds. Returns: list[SectorTopMutualFundsEntry]: A list of top mutual funds in the sector.
get_corporate_actionsRead-onlyRetrieve corporate actions for a stock. Args: ticker (str): The symbol of the stock. Returns: list[CorporateActions]: List of corporate action records.
get_curated_infoRead-onlyRetrieve curated stock fundamental overview (33 essential metrics). Optimized for LLM reasoning to avoid context window bloat. Args: ticker (str): The symbol of the stock. Returns: StockInfo_v2: Curated stock information.
get_dividend_summaryRead-onlyRetrieve a summary of dividend data for a stock. Args: ticker (str): The symbol of the stock. Returns: dict: Dividend summary data.
get_dividendsRead-onlyRetrieve dividend history for a stock. Args: ticker (str): The symbol of the stock. Returns: list[StockDividends]: List of dividend records.
get_extended_financial_summaryRead-onlyRetrieve the financial summary plus valuation and share-count metrics. A superset of get_financial_summary, adding market cap, enterprise value, share counts, book value and price-to-book. Args: ticker (str): The symbol of the stock. Returns: ExtendedFinancialSummary: Financial summary with valuation metrics.
get_fast_infoRead-onlyRetrieve fast info for a specific stock ticker. Args: ticker (str): The symbol of the stock. Returns: StockFastInfo: Fast info data for the given ticker.
get_financial_summaryRead-onlyRetrieve profitability, liquidity and cash-flow metrics for a stock. Covers revenue, margins, cash flow, debt and return ratios. Use get_extended_financial_summary instead when valuation or share-count metrics are also needed. Args: ticker (str): The symbol of the stock. Returns: FinancialSummary: Profitability, liquidity and cash-flow metrics.
get_historyRead-onlyRetrieve historical price data for a stock. Args: ticker (str): The symbol of the stock. period (str, optional): Valid periods: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max. Defaults to '1y'. interval (str, optional): Valid intervals: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo. Defaults to '1d'. Returns: list[StockHistory]: List of historical data points.
get_infoRead-onlyRetrieve detailed info for a specific stock ticker. Args: ticker (str): The symbol of the stock. fields (list[str], optional): Specific field names to return (e.g. ['marketCap', 'trailingPE']). If omitted, returns the complete StockInfo model. Returns: StockInfo | dict: Detailed info data or pruned dictionary of requested fields.
get_newsRead-onlyRetrieve news items for a stock. Args: ticker (str): The symbol of the stock. Returns: list[NewsItem]: List of news items.
get_price_targetRead-onlyRetrieve price target data for a stock. Args: ticker (str): The symbol of the stock. Returns: dict: Price target data.
get_quick_technical_indicatorsRead-onlyRetrieve quick technical indicators for a stock. Args: ticker (str): The symbol of the stock. Returns: dict: Technical indicators data.
get_risk_metricsRead-onlyRetrieve risk metrics for a stock. Args: ticker (str): The symbol of the stock. Returns: dict: Risk metrics data.
get_splitsRead-onlyRetrieve stock split history for a stock. Args: ticker (str): The symbol of the stock. Returns: list[StockSplit]: List of stock split records.
get_valuation_historyRead-onlyRetrieve historical valuation ratios (P/E, P/S, P/B, EV/EBITDA, PEG, market cap, enterprise value) for a stock, one entry per period. Unlike get_financial_summary or get_extended_financial_summary, which are a current snapshot, this returns a short history so trend can be seen across recent quarters or years. Args: ticker (str): The symbol of the stock. freq (str, optional): Period-column grouping: 'quarterly', 'monthly', 'yearly' or 'trailing'. Defaults to 'quarterly'. periods (int | None, optional): Number of period columns to return, newest first. None returns all available history; 0 returns only the current value. Defaults to 5. Returns: list[ValuationMeasuresEntry]: Valuation ratios per period, newest first. Empty for instruments valuation measures do not apply to (e.g. cryptocurrencies).
get_wsj_bollinger_bandsRead-onlyRetrieve server-side computed Bollinger Bands (upper, middle, lower, bandwidth) from WSJ Michelangelo. Calculated natively on the WSJ charting servers, minimizing client compute overhead. Args: ticker: Stock symbol (e.g. 'TSLA', 'NVDA'). window: Moving average calculation window (default 20). multiplier: Standard deviation multiplier (default 2.0). timeframe: Timespan duration (e.g. 'P1M', 'P3M', 'P1Y'). step: Bar step frequency (e.g. 'P1D', 'PT1M'). Returns: WSJBollingerBandsSeries containing timestamped price, lower band, middle band, upper band, and bandwidth %.
get_wsj_intraday_barsRead-onlyRetrieve high-resolution intraday continuous tick bars (including pre-market and after-hours) from WSJ. Args: ticker: Stock symbol (e.g. 'TSLA', 'AAPL'). timeframe: Intraday duration: 'D1' (today), 'D5' (past 5 days), 'D7' (past 7 days). step: Bar frequency: 'PT1M' (1-minute bars), 'PT5M' (5-minute bars), 'PT15M' (15-minute bars). Returns: WSJStockHistory containing continuous 1-minute intraday bars with volume.
get_wsj_stock_historyRead-onlyRetrieve historical price bars (OHLCV) for a stock directly from WSJ Michelangelo. Args: ticker: Stock symbol (e.g. 'TSLA', 'AAPL', 'NVDA', 'MSFT'). timeframe: Timespan duration: 'D7' (7 days), '1mo', 'P3M', 'P1Y', '5y', 'all'. step: Bar frequency: 'P1D' (daily), 'PT1M' (1-minute intraday), 'PT5M' (5-minute). Returns: WSJStockHistory with ordered historical OHLCV price bars.
get_support_resistance_levelsRead-onlyRetrieve support and resistance levels for a given ticker and period. Args: ticker (str): The symbol of the security. period (str, optional): Time period for levels (e.g., '6mo'). Defaults to '6mo'. Returns: SupportResistanceLevelsDict: Support and resistance levels data.
get_technical_indicatorsRead-onlyRetrieve technical indicators for a given ticker and period. Args: ticker (str): The symbol of the security. period (str, optional): Time period for indicators (e.g., '6mo'). Defaults to '6mo'. Returns: TechnicalIndicatorsDict: Technical indicators data.
get_volatility_metricsRead-onlyRetrieve volatility metrics for a given ticker and period. Args: ticker (str): The symbol of the security. period (str, optional): Time period for metrics (e.g., '1y'). Defaults to '1y'. Returns: VolatilityMetricsDict: Volatility metrics data.
get_wsj_emaRead-onlyRetrieve server-side computed Exponential Moving Average (EMA) from WSJ Michelangelo. Args: ticker: Symbol (e.g. 'NVDA', 'MSFT'). window: Moving average calculation window period (default 20). timeframe: Timespan duration (e.g. 'P1M', 'P3M', 'P1Y'). step: Bar step frequency (e.g. 'P1D', 'PT1M'). Returns: WSJIndicatorSeries with timestamped price and computed EMA values.
get_wsj_macdRead-onlyRetrieve server-side computed Moving Average Convergence Divergence (MACD) from WSJ. Calculates MACD line, signal line, and MACD histogram natively on WSJ charting servers. Args: ticker: Symbol (e.g. 'TSLA', 'AAPL'). fast_window: Fast EMA period (default 12). slow_window: Slow EMA period (default 26). signal_window: Signal line EMA period (default 9). timeframe: Timespan duration (e.g. 'P1M', 'P3M', 'P1Y'). step: Bar step frequency (e.g. 'P1D', 'PT1M'). Returns: WSJMACDSeries containing timestamped price, MACD line, signal line, and histogram.
get_wsj_rsiRead-onlyRetrieve server-side computed Relative Strength Index (RSI) momentum indicator from WSJ. Args: ticker: Symbol (e.g. 'TSLA', 'AAPL'). window: RSI calculation period (default 14). timeframe: Timespan duration (e.g. 'P1M', 'P3M', 'P1Y'). step: Bar step frequency (e.g. 'P1D', 'PT1M'). Returns: WSJIndicatorSeries with timestamped price and RSI values (0-100).
get_wsj_smaRead-onlyRetrieve server-side computed Simple Moving Average (SMA) from WSJ Michelangelo. Calculated directly on WSJ charting servers, providing ultra-low-latency moving averages. Args: ticker: Symbol (e.g. 'AAPL', 'TSLA', 'SPX'). window: Moving average calculation window period (default 50). timeframe: Timespan duration (e.g. 'P1M', 'P3M', 'P1Y', '5y'). step: Bar step frequency (e.g. 'P1D', 'PT1M'). Returns: WSJIndicatorSeries with timestamped price and computed SMA values.
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubOpen Markets
A production-grade Model Context Protocol (MCP) server for agentic financial data retrieval and algorithmic market analysis. Open Markets connects LLM agents directly to real-time and historical financial intelligence across equities, fixed income, commodities, currencies, derivatives, funds, crypto, macroeconomic telemetry, SEC EDGAR regulatory disclosures, and quantitative portfolio risk analytics.
🌟 Multi-Provider Architecture
Open Markets aggregates financial telemetry across institutional-grade data providers:
- SEC EDGAR Direct Ingestion Engine: Official regulatory submissions, real-time 10-K annual reports, 10-Q quarterly reports, 8-K material events, Form 4 insider transactions, and structured US-GAAP interactive XBRL disclosures with direct document links.
- Federal Reserve Economic Data (FRED Engine): Comprehensive macroeconomic indicators (CPI Inflation, Core PCE, Effective Fed Funds Rate, SOFR, Nonfarm Payrolls, Unemployment, Real GDP, M2 Money Supply, Fed Balance Sheet, TIPS Breakeven Inflation, and Financial Stress).
- Wall Street Journal (WSJ Michelangelo Engine): High-resolution 1-minute intraday continuous ticks (with pre/post-market), continuous commodities & futures, server-side technical indicators (SMA, EMA, RSI, MACD, Bollinger Bands), global equity benchmark indices, and sovereign bond curves.
- Yahoo Finance Engine: Complete fundamental statements, real-time quotes, options chains, analyst consensus, institutional ownership, ETF compositions, and screener queries.
- Quantitative Portfolio & Backtesting Engine: Vectorized multi-asset Sharpe/Sortino ratios, Value-at-Risk (VaR/CVaR), correlation matrices, equal-risk-contribution allocation, constrained Markowitz Minimum Variance optimization, and SMA/RSI strategy backtesting.
- Green Markets (Bloomberg / Dow Jones): Weekly North American fertilizer price index benchmark.
All network requests use modern Chrome TLS/JA3-impersonation (curl_cffi), automatic session pooling, thread-safe asynchronous concurrency, and configurable in-memory TTL caching.
🚀 Quick Start
Installation with uvx
uvx openmarkets
Usage with Claude Code
Install the Open Markets plugin from this repository:
claude plugin marketplace add danchev/openmarkets
claude plugin install openmarkets@openmarkets
The plugin starts openmarkets@latest with uvx and registers all MCP tools automatically.
Usage with Cursor
Usage with Claude Desktop
Download and open the Desktop Extension for one-click installation:
Alternatively, add Open Markets to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"openmarkets": {
"command": "uvx",
"args": ["openmarkets@latest"]
}
}
}
Usage with VS Code & Cline
Add to .vscode/mcp.json:
{
"servers": {
"openmarkets": {
"command": "uvx",
"args": ["openmarkets@latest"]
}
}
}
🎯 Tool Profiles
Open Markets supports granular server profiles to tailor tool exposure to specific LLM contexts:
# Run with specific domain profile
uvx openmarkets --profile equities
uvx openmarkets --profile macro
uvx openmarkets --profile quant
uvx openmarkets --profile portfolio
uvx openmarkets --profile sec
| Profile | Exposed Services & Focus |
|---|---|
full (default) |
All 127 tools across all 17 services. |
equities |
stock, financials, analysis, holdings, options, portfolio, screener, sec. |
quant |
stock, technical_analysis, sector_industry, markets, crypto, funds, commodities, fixed_income, forex, macroeconomics, portfolio. |
portfolio |
Multi-asset Sharpe/Sortino, Value-at-Risk (VaR/CVaR), correlation matrices, equal-risk-contribution risk parity, Minimum Variance, rolling Beta, and strategy backtesters. |
macro |
commodities, fixed_income, forex, markets, sector_industry, macroeconomics. |
sec |
Direct SEC EDGAR submissions, 10-K, 10-Q, 8-K, Form 4, CIK search, and interactive XBRL financial statement facts. |
minimal |
Essential 36 tools across stock, financial, analyst, and screener lookups. |
macroeconomics |
US Inflation, PCE, labor markets, Fed rates, GDP, M2, liquidity, and financial stress. |
commodities |
Physical commodities, energy, metals, softs, and fertilizer indices. |
fixed_income |
Treasury yield curves and 10Y sovereign benchmark yield spreads. |
forex |
Foreign exchange rates, DXY dollar index, and currency conversions. |
crypto |
Top cryptocurrencies, historical crypto pricing, and fear & greed index proxy. |
🛠️ Complete Directory of 127 MCP Tools
Open Markets publishes 127 strictly-typed, Pydantic-validated tools across 17 domain services:
1. Stock & Equities (StockService — 18 tools)
get_fast_info(ticker): Fast summary with real-time price, market cap, 52-week bounds, and currency.get_info(ticker): Exhaustive company metadata, valuation ratios, enterprise multiples, and governance.get_curated_info(ticker): Context-efficient company fundamentals with 33 essential metrics.get_history(ticker, period, interval): Historical OHLCV pricing with custom intervals (1m to 3mo).get_dividends(ticker): Historical dividend payout schedule and cash amounts.get_splits(ticker): Historical stock split ratios and execution dates.get_corporate_actions(ticker): Combined stream of splits and dividend distributions.get_news(ticker): Latest real-time financial news headlines and article links.get_financial_summary(ticker): Core financial health snapshot (Revenue, Net Income, Margins, Debt).get_extended_financial_summary(ticker): Deep financial metrics (Free Cash Flow, ROE, ROA, Quick Ratio).get_risk_metrics(ticker): Risk indicators including Beta and institutional short interest.get_dividend_summary(ticker): Payout ratio, trailing/forward dividend yields, and 5-year averages.get_price_target(ticker): Analyst consensus price targets (Low, Mean, Median, High).get_quick_technical_indicators(ticker): Lightweight 50-day & 200-day moving average levels.get_valuation_history(ticker): Quarterly & annual historical valuation ratios (P/E, P/S, P/B, EV/EBITDA).get_wsj_stock_history(ticker, timeframe, step): WSJ institutional price history with custom timeframes.get_wsj_intraday_bars(ticker): Continuous 1-minute intraday tick data including pre-market and after-hours.get_wsj_bollinger_bands(ticker, timeframe, window, num_std): Server-side calculated Bollinger Bands directly from WSJ.
2. Technical Analysis (TechnicalAnalysisService — 7 tools)
get_technical_indicators(ticker, period): Comprehensive moving averages and 52-week position metrics.get_volatility_metrics(ticker, period): Annualized volatility, maximum daily gains/losses, win/loss day ratios.get_support_resistance_levels(ticker, period): Identified dynamic support and resistance price floors/ceilings.get_wsj_sma(ticker, window, timeframe, step): Server-side computed Simple Moving Average (SMA) via WSJ Michelangelo.get_wsj_ema(ticker, window, timeframe, step): Server-side computed Exponential Moving Average (EMA).get_wsj_rsi(ticker, window, timeframe, step): Server-side computed Relative Strength Index (RSI momentum).get_wsj_macd(ticker, fast_window, slow_window, signal_window): Server-side computed MACD Line, Signal Line, and Histogram.
3. Financial Statements & SEC Filings (FinancialsService — 9 tools)
get_curated_financials(ticker): Context-efficient financial performance and solvency snapshot.get_balance_sheet(ticker, quarterly): Standardized balance sheet statements (Assets, Liabilities, Equity).get_income_statement(ticker, quarterly): Income statements (Revenues, Gross Profits, Operating Income, Net Income).get_ttm_income_statement(ticker): Trailing Twelve Months (TTM) income statement.get_ttm_cash_flow_statement(ticker): Trailing Twelve Months (TTM) cash flow statement.get_financial_calendar(ticker): Upcoming earnings release dates and dividend announcement schedules.get_sec_filings(ticker): Official EDGAR SEC filings (10-K, 10-Q, 8-K) with direct document URLs.get_eps_history(ticker): Historical EPS consensus estimates versus reported actuals and surprise percentages.get_full_financials(ticker): Concurrent aggregate of statements, calendar, filings, and EPS history.
4. Analyst Estimates & Consensus (AnalysisService — 8 tools)
get_analyst_recommendations(ticker): Wall Street consensus ratings breakdown (Strong Buy, Buy, Hold, Sell).get_recommendation_changes(ticker): Recent rating upgrades and downgrades from major investment banks.get_revenue_estimates(ticker): Forward revenue projections and quarterly growth estimates.get_earnings_estimates(ticker): Forward EPS estimates (Quarterly & Annual).get_growth_estimates(ticker): Multi-year earnings growth forecast comparisons.get_eps_trends(ticker): Historical EPS revision trends (30 days, 60 days, 90 days ago).get_price_targets(ticker): Wall Street price targets with high, low, and median projections.get_full_analysis(ticker): Unified analyst research summary report.
5. Options & Derivatives (OptionsService — 7 tools)
get_option_expiration_dates(ticker): Available options chain expiration dates.get_option_chain(ticker, expiration_date): Complete options chain with calls and puts.get_call_options(ticker, expiration_date): Filtered call options with strike, bid/ask, volume, and open interest.get_put_options(ticker, expiration_date): Filtered put options.get_options_volume_analysis(ticker, expiration_date): Aggregate Put/Call volume and Open Interest ratios.get_options_by_moneyness(ticker, expiration_date, moneyness_range): ITM, ATM, and OTM options filtered by moneyness.get_options_skew(ticker, expiration_date): Volatility smile and implied volatility (IV) skew metrics.
6. Institutional Holdings & Insider Trades (HoldingsService — 6 tools)
get_major_holders(ticker): Ownership breakdown (Insiders, Institutions, Float percentages).get_institutional_holdings(ticker): Top institutional asset managers (Vanguard, BlackRock, etc.) and shares held.get_mutual_fund_holdings(ticker): Top mutual fund holders and portfolio portfolio position weights.get_insider_purchases(ticker): Six-month insider purchase/sale share and transaction counts.get_insider_roster_holders(ticker): Key company officers and board member share positions.get_full_holdings(ticker): Unified institutional and insider ownership report.
7. Stock Screener (ScreenerService — 1 tool)
search_screener_matches(query, count, offset): Paginated discovery across Yahoo's predefined equity, ETF, and fund screens.
8. Sectors & Industry Analytics (SectorIndustryService — 13 tools)
get_sector_overview(sector): Macro sector performance and key valuation metrics.get_sector_overview_for_ticker(ticker): Sector intelligence inferred from any ticker.get_sector_top_companies(sector): Leading corporations by market capitalization in a sector.get_sector_top_companies_for_ticker(ticker): Sector peers for any given ticker.get_sector_top_etfs(sector): Benchmark ETFs representing the sector.get_sector_top_mutual_funds(sector): Top mutual funds specialized in the sector.get_sector_industries(sector): Sub-industry breakdown and market weightings within a sector.get_sector_research_reports(sector): Sector research notes and macro updates.get_all_industries(): Complete directory of market industries.get_industry_overview(industry): Industry growth, valuation, and market capitalization.get_industry_top_companies(industry): Industry market leaders by market cap.get_industry_top_growth_companies(industry): Fastest revenue and earnings growers in an industry.get_industry_top_performing_companies(industry): Top price momentum leaders within an industry.
9. Global Markets & Volatility (MarketsService — 4 tools)
get_market_summary(market): Regional market overview (US, Europe, Asia).get_market_status(market): Real-time open/closed status for major global exchanges.get_global_indices(): Live snapshot across world benchmark indices (S&P 500, Dow Jones, Nasdaq, Russell 2000, DAX 40, FTSE 100, CAC 40, Euro Stoxx 50, Nikkei 225, Hang Seng, VIX).get_volatility_vix(): Real-time quote for CBOE Volatility Index (VIX / Wall Street Fear Gauge).
10. Fixed Income & Sovereign Debt (FixedIncomeService — 3 tools)
get_treasury_yield_curve(): Complete US Treasury yield curve snapshot (1M to 30Y), 2Y/10Y spread, 3M/10Y spread, and inversion status.get_treasury_yield_history(maturity, timeframe, step): Historical yield timeseries for any Treasury tenor.get_global_sovereign_yields(): Benchmark 10-year sovereign yields and basis-point spreads vs US 10Y across 9 nations (US, Germany, UK, Japan, Canada, France, Italy, Australia, Spain).
11. Physical Commodities & Agriculture (CommoditiesService — 8 tools)
get_commodity_quote(symbol): Real-time price quote for Energy, Metals, Agriculture, Livestock, or Softs.get_commodity_history(symbol, timeframe, step): Historical continuous futures price charts.get_energy_prices(): Multi-quote snapshot for WTI Crude, Brent, Natural Gas, Gasoline, and Heating Oil.get_metals_prices(): Multi-quote snapshot for Gold, Silver, Copper, Platinum, and Palladium.get_agriculture_prices(): Multi-quote snapshot for Wheat, Corn, Soybeans, Coffee, and Sugar.get_livestock_prices(): Live snapshot for Live Cattle, Feeder Cattle, and Lean Hogs.get_softs_prices(): Live snapshot for Coffee, Sugar, Cocoa, and Cotton.get_fertilizer_price_index(): Green Markets North American Fertilizer Price Index weekly benchmark timeseries.
12. Foreign Exchange (ForexService — 4 tools)
get_forex_quote(pair): Real-time FX exchange rate (e.g.EURUSD,USDJPY,GBPUSD).get_forex_history(pair, timeframe, step): Historical FX exchange rate timeseries.get_dollar_index_dxy(): Real-time quote for the US Dollar Index (DXY).get_major_currencies(): Currency matrix across EUR, GBP, JPY, CAD, AUD, CHF, CNH.
13. ETFs & Mutual Funds (FundsService — 8 tools)
get_fund_info(ticker): ETF/Fund profile, expense ratio, AUM, category, and NAV.get_fund_sector_weighting(ticker): Fund portfolio sector allocations and percentage weights.get_fund_operations(ticker): Annual turnover, minimum investment, and operational parameters.get_fund_overview(ticker): Unified fund overview with performance and fee metrics.get_fund_top_holdings(ticker): Top underlying portfolio holdings and percentage weights.get_fund_bond_holdings(ticker): Bond ratings breakdown, effective duration, and maturity metrics.get_fund_equity_holdings(ticker): Equity price-to-earnings, price-to-book, and median market cap.get_fund_asset_class_holdings(ticker): Asset class allocations (Cash, Stocks, Bonds, Real Estate).
14. Cryptocurrency (CryptoService — 4 tools)
get_crypto_info(symbol): Cryptocurrency price, market cap, 24h volume, and circulating supply.get_crypto_history(symbol, period, interval): Historical OHLCV crypto price bars.get_top_cryptocurrencies(count): Quotes for the configured major-cryptocurrency watchlist (not a live ranking).get_crypto_fear_greed_proxy(): Volatility and momentum proxy for crypto market sentiment.
15. Macroeconomics & Federal Reserve Telemetry (MacroeconomicsService — 9 tools)
get_cpi_inflation(limit): US Consumer Price Index (Headline CPI & Core CPI) and YoY inflation rates.get_pce_inflation(limit): US Core Personal Consumption Expenditures (PCE) Price Index (Fed's primary 2% inflation target).get_employment_indicators(limit): Civilian Unemployment Rate (%) and Total Nonfarm Payrolls with monthly net job additions.get_interest_rates_telemetry(limit): Benchmark US money market rates: Effective Federal Funds Rate (EFFR) and SOFR.get_gdp_growth(limit): Real GDP ($B chained 2017) and Nominal GDP ($B) with quarter-over-quarter annualized real growth rates.get_money_supply_and_fed_balance_sheet(limit): US M2 Money Supply ($B) and Federal Reserve Balance Sheet Total Assets ($M).get_inflation_expectations(limit): 5-Year and 10-Year market-implied Breakeven Inflation Rates from TIPS.get_financial_stress_and_credit_spreads(limit): St. Louis Fed Financial Stress Index and ICE BofA US High Yield OAS credit spreads.get_macroeconomic_series(series_id, limit): Universal query tool for any valid FRED economic series identifier (e.g.MORTGAGE30US,INDPRO,UMCSENT).
16. SEC EDGAR Filings & XBRL Disclosures (SECService — 9 tools)
get_sec_company_profile(ticker): Official SEC corporate registrant profile, 10-digit CIK, SIC code, business address, and incorporation metadata.get_sec_recent_filings(ticker, form_type, limit): Recent official regulatory submissions with direct HTTPS links to primary documents on SEC EDGAR.get_sec_10k_annual_filings(ticker, limit): Form 10-K audited annual financial reports with direct primary document links.get_sec_10q_quarterly_filings(ticker, limit): Form 10-Q quarterly reports with unaudited financial statements.get_sec_8k_material_events(ticker, limit): Form 8-K unscheduled material corporate event announcements (earnings releases, executive changes, M&A).get_sec_insider_form4_filings(ticker, limit): Form 4 insider transaction reports by officers, directors, and 10%+ beneficial owners.get_sec_xbrl_company_facts(ticker): Catalog summary of all available interactive US-GAAP XBRL disclosure concepts filed by an entity.get_sec_xbrl_concept_timeseries(ticker, concept, limit): Multi-quarter historical timeseries for standard GAAP concepts (REVENUES,NET_INCOME,GROSS_PROFIT,ASSETS,CASH,EPS).get_sec_cik_lookup(query, limit): Fast search directory resolving company names and tickers to official 10-digit SEC CIKs across 10,000+ public entities.
17. Quantitative Portfolio Risk & Strategy Backtesting (PortfolioService — 9 tools)
calculate_portfolio_risk_metrics(tickers, weights, benchmark, period, risk_free_rate): Multi-asset Sharpe/Sortino/Calmar ratios, Max Drawdown, Historical VaR (95%/99%), Expected Shortfall (CVaR), Beta, and Alpha.calculate_asset_correlation_matrix(tickers, period): Pairwise Pearson correlation matrix and annualized covariance matrix across cross-asset baskets.calculate_risk_parity_weights(tickers, period): Inverse-volatility allocation weights with actual covariance-based risk contributions.calculate_minimum_variance_portfolio(tickers, period): Analytical long-only Markowitz Minimum Variance portfolio allocation weights.calculate_rolling_beta(ticker, benchmark, window, period): Historical rolling window Beta sensitivity series tracking evolving market risk.calculate_drawdown_series(tickers, weights, period): Historical underwater percentage drawdown curve and peak/trough timeline points.backtest_trend_following_strategy(ticker, fast_window, slow_window, period, initial_capital): Moving Average Crossover (Golden Cross / Death Cross) rule-based backtester with win rate, profit factor, and equity curve.backtest_mean_reversion_strategy(ticker, rsi_window, oversold_threshold, overbought_threshold, period, initial_capital): RSI Mean-Reversion strategy backtester with closed trades and performance breakdown.calculate_factor_exposures(ticker, period): Multi-factor linear regression estimating systematic market loadings (SPY, QQQ, IWM, TLT, GLD) and Jensen's Alpha.
🔧 HTTP Transport & Production Deployment
Open Markets can be run as a standalone HTTP service supporting SSE streaming, Bearer token authentication, CORS, and Prometheus metrics:
# Run streamable HTTP server with auth
uvx openmarkets@latest \
--transport http \
--host 0.0.0.0 \
--port 8000 \
--http-auth-enabled \
--http-auth-secret "your-production-secret"
Endpoints:
GET /health— Process liveness probe.GET /metrics— Prometheus metrics (uptime, cache entries).POST /mcp— MCP streamable JSON-RPC endpoint.
📄 License
AGPLv3+ License — see LICENSE for details.
Open Markets MCP questions
How do I add Open Markets MCP to Claude Code?
Run claude mcp add openmarkets -- uvx openmarkets in your terminal. Add --scope user to make it available in every project.
How do I add Open Markets MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Open Markets MCP provide?
It exposes 127 tools, including get_analyst_recommendations, get_earnings_estimates, get_eps_trends, get_full_analysis, get_growth_estimates.
What kind of financial data does Open Markets provide?
It provides data across equities, fixed income, commodities, currencies, derivatives, funds, crypto, macroeconomic telemetry, and SEC EDGAR regulatory disclosures.
Can I run the server with a specific focus?
Yes, you can use granular server profiles like equities, macro, quant, portfolio, or sec to tailor the available tools to your specific needs.
How many tools are available in the server?
The server provides 127 strictly-typed, Pydantic-validated tools organized across 17 domain services.