Model Context Protocol (MCP) server for freee API integration
Nothing to run from here
MetricDuck — Financial Analysis is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
22
tools declared
—
trust score
remote
at its publisher
—
calls last 7d
What it does
SEC data layer for AI agents — financials, screening, every figure traceable to its filing.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http metricduck-financial-analysis-mcp https://mcp.metricduck.com/mcp
# 2 — ask your agent for something these tools do
# browse_company, search_companies, get_company_overview and 19 more
MetricDuck — Financial Analysis costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
MEAll 1 server
metricduck1 server
1 category
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http metricduck-financial-analysis-mcp https://mcp.metricduck.com/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
22 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Use this when the user asks what MetricDuck has on a company or wants to start researching one: "what filings do you have for X?", "what's notable about X?", "where do I start on X?". One call returns the company's identity (ticker, name, CIK), its filings with extracted text by form type (10-K, 10-Q, 8-K, proxy), which filing signals fire (M&A, partnerships, guidance changes, accounting flags), t
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Company name, ticker, or 10-digit zero-padded CIK. Accepts free-text fuzzy match like 'US Steel' or 'AAPL'. For delisted companies, prefer the CIK. |
| include_delisted | boolean | no | Include delisted companies among FUZZY candidates (ticker-prefix / name matches). Default false. A delisted company always resolves by its exact ticker, former ticker, or CIK regardless of this flag — |
Use this when you have a company name or an ambiguous ticker and need the exact ticker (or CIK) before calling other tools. Fuzzy name/ticker match: handles partial names ("micro" -> MSFT), typos, and ticker variations. Returns ticker, full name, CIK, SIC, filer type (domestic / foreign private issuer / fund — i.e. which form family to expect), fiscal year-end, and the SEC EDGAR entity-page link (
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Company name or ticker (supports partial matches and typos). 2-5 uppercase letters are read as a ticker: pass an all-caps NAME that is not a ticker ("AMCOR") in normal casing ("Amcor"). A miss returns |
| limit | integer | no | Maximum results (default 5, max 20) |
Get comprehensive financial overview for a company in a single call. Includes: current price, valuation (P/E, P/B, EV multiples, PEG), profitability (revenue, margins, returns), cash flow (OCF, FCF, yields), balance sheet (debt, equity, ratios), capital allocation (buybacks, shares outstanding, shareholder yield), business segment + geographic revenue mix (latest 10-K, with YoY change), latest ea
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'AAPL', 'MSFT'). Must be exact — search_companies resolves a name. |
| depth | string | no | Response shape preset. 'snapshot' = headline facts only (~2K chars: key signals, filing-signal summary, flags, latest filing pointers) — best for multi-ticker sequencing or quick checks. 'core' (defau |
Daily end-of-day stock prices (open/high/low, close, split- & dividend-adjusted adj_close, volume) for US exchange-listed companies. Sourced from a market-data feed, not SEC filings. Markets are open only on business days, so rows exist ONLY for trading days — the data IS the trading calendar: - Price ON OR AFTER a date (a single date, or an announcement landing on a weekend): pass start_date=<da
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'AAPL'). US exchange-listed (NYSE/Nasdaq/AMEX), 1–5 letters. |
| start_date | string | no | Window start (YYYY-MM-DD). Markets trade only on business days — if this date is a weekend/holiday the FIRST returned row is the next OPEN day (the price ON OR AFTER this date). Omit end_date to fetch |
| end_date | string | no | Window end (YYYY-MM-DD). The LAST returned row on/before this date is the price ON OR BEFORE it. Omit start_date to fetch just the price on/before this date. |
| limit | integer | no | Max rows (newest first if the window exceeds it). Default 30. With start_date alone, the short forward window is returned whole. For a point-to-point return over a long span, make TWO narrow-window ca |
Get multi-period financial statements: income statement, balance sheet, and cash flow in one call. Returns quantitative historical data with key metrics and trends. Default: all 3 statements, quarterly, 2 years. For qualitative analysis (risks, accounting quality, management tone), use get_filing_index (signal map) then get_filing_section to read the text. Use Cases: - "Show me AAPL's financials
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'AAPL'). Must be exact. |
| period | string | no | Time period granularity |
| years | integer | no | Years of history (default 2, max 10) |
| statements | array | no | Which statements to include (default: all three) |
| vantage_date | string | no | As-of vantage (YYYY-MM-DD): restrict to filings PUBLISHED on or before this date, and cite the filing that was current then. Omit for the latest. IMPORTANT — this bounds which FILINGS are visible and |
Compare a company against peers across ~70 curated fundamental metrics (TTM by default; period_type FY or Q for each company's latest fiscal year or quarter), with percentile rankings and relative strengths/weaknesses. Returns a side-by-side table covering valuation (P/E, P/B, EV/EBITDA, EV/Sales, FCF yield), profitability (gross/operating/net/EBITDA margins, ROE, ROA, ROIC), leverage & liquidity
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Primary company ticker symbol to compare (e.g., 'AAPL'). Must be exact. |
| custom_peers | string | no | Optional comma-separated peer tickers (e.g., 'MSFT,GOOG,AMZN'). Auto-selected if omitted. |
| peer_mode | string | no | Peer selection method: 'sector' (same sector + similar market cap, default) or 'tags' (business model similarity — finds companies with overlapping classification tags). Use 'tags' for cross-sector bu |
| metrics | string | no | Optional comma-separated metric_ids to show instead of the default curated table (e.g. 'dividend_payout_ratio,dividend_yield,ev_ebitda,roa,interest_coverage'). Drawn from the ~70 curated fundamentals. |
| period_type | string | no | 'TTM' (default): trailing twelve months. 'FY': each company's latest reported fiscal year. 'Q': each company's latest reported fiscal quarter. Each company is at ITS OWN latest period (fiscal years en |
Screen 5,500+ US companies by financial metrics. Find stocks matching quantitative criteria. Metric IDs, period types (incl. growth: period_type="ttm.yoy") and sector codes are listed on the filters / sectors parameters. LATEST-snapshot values; full history via get_metric_history. Tag filtering (required_tags / excluded_tags) selects by business-model classification; unclassified companies a
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filters | array | yes | Metric filters |
| sort_by | string | no | Metric ID to sort by (default: 'market_cap') |
| sectors | array | no | Sector codes: TECH, FIN, HEALTH, CONS_STAPLES, CONS_DISC, IND, ENERGY, UTIL, RE, MAT, COMM. |
| required_tags | array | no | Classification tags all results must have (e.g., ['ai_ml_infrastructure', 'subscription_recurring']). Tags: cloud_infrastructure, saas_enterprise, saas_smb, marketplace_platform, semiconductor_design, |
| excluded_tags | array | no | Classification tags results must NOT have (e.g., ['china_supply_chain_heavy', 'regulated_industry']). |
| limit | integer | no | Max results (default 20, max 50). Responses cap at ~20K chars: a lower limit or stricter filters keep them whole. |
Use this when the user asks which filings a company has made — its 10-K annual reports, 10-Q quarterly reports, 8-K current reports (earnings releases, events, call transcripts), proxy statements (DEF 14A), or 20-F / 40-F / 6-K for foreign issuers — or needs one specific past filing. Returns each filing's form type, dates and accession number, plus per-section sizes (words, chunks, tables) for 10-
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | Company ticker symbol (e.g., 'AAPL'). Must be exact. Either ticker or cik required. |
| cik | string | no | 10-digit SEC CIK as alternative to ticker. Use for delisted/acquired companies (e.g., Z=Zillow ticker may not resolve; pass cik='0001617640' instead). Either ticker or cik required. |
| form_type | string | no | Filter by form type: 10-K annual, 10-Q quarterly, 8-K current reports, DEF 14A proxy; 20-F/40-F annual and 6-K interim for foreign private issuers. Other forms (424B2, FWP, 13F-HR, 4): search_sec_fili |
| form_subtype | string | no | Filter 8-K filings by sub-type (derived from section inventory): earnings releases; event = M&A / exec changes / debt; transcript = earnings calls; other = misc. Implicitly narrows to form_type='8-K'. |
| years | integer | no | Years of filing history (default 2, max 7). Ignored when fiscal_year is set. |
| fiscal_year | integer | no | Pick a specific fiscal year (e.g., 2020). Resolved via the XBRL period index — correct for non-calendar fiscal years (a 10-K filed Feb 2024 is FY2023). Alone, lists all of that fiscal year's filings ( |
| fiscal_period | string | no | Pick a specific fiscal period. FY = annual (10-K / 20-F / 40-F); Q1/Q2/Q3 = quarterly (10-Q). The 4th quarter is reported in the annual 10-K, so Q4 is treated as FY. Combine with fiscal_year to pin a |
| vantage_date | string | no | As-of vantage (YYYY-MM-DD): only list filings filed ON OR BEFORE this date (point-in-time). Omit to list the most recent filings. For vantages older than the years window, pass a larger years. |
| include_delisted | boolean | no | Opt in to historical data for a delisted company. Default false returns a structured 'delisted' error (HTTP 410) naming the delisting date. Querying by cik bypasses this gate. Applies to 10-K/10-Q/DEF |
Use this when the user asks what a 10-K, 10-Q or 8-K says — risk factors, MD&A, the business description, an earnings release and its guidance / outlook, an 8-K event, a proxy (DEF 14A) — and for earnings call transcript Q&A or prepared remarks, where MetricDuck has the transcript. Returns the section's text, paginated, from the latest filing or a specific one. Two modes: 1. **Section mode (d
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | Company ticker symbol (e.g., 'AAPL'). Required unless cik is provided. |
| cik | string | no | 10-digit SEC CIK as an alternative to ticker — use for delisted/acquired companies (e.g. Activision cik='0000718877') whose ticker no longer resolves. |
| include_delisted | boolean | no | Query a delisted/acquired company by its old ticker. Default false returns a structured delisted error pointing at the CIK. |
| section_id | string | no | Section ID — omit it (with accession_number set) for outline mode. Common IDs by category: 10-K / 10-Q core: risk_factors, business_description, mda_full, mda_results_operations, `mda_l |
| accession_number | string | no | Filing accession number from list_filings. Latest filing used if omitted. |
| form_type | string | no | Form type filter (picks the latest of that type when accession_number is omitted). 20-F/40-F/6-K cover foreign private issuers. Other forms (424B2, FWP, 13F-HR, 4): search_sec_filings(query, company, |
| fiscal_year | integer | no | Fiscal year to look up (e.g., 2023). Resolves to that fiscal year's filing via the XBRL period index — correct for non-calendar fiscal years (e.g. a 10-K filed Feb 2024 covers FY2023, not FY2024). Com |
| fiscal_period | string | no | Fiscal period: 'Q1'/'Q2'/'Q3' for a quarter's 10-Q, or 'FY' for the annual 10-K (the default when omitted). Resolved via the XBRL DEI period index (correct for non-calendar fiscal years). The fourth q |
| vantage_date | string | no | As-of vantage (YYYY-MM-DD): serve the latest filing filed ON OR BEFORE this date — don't assume the newest filing reflects a past vantage. Omit for the latest. Ignored if accession_number is provided. |
| offset | integer | no | Chunk offset for pagination (default 0) |
| char_offset | integer | no | Within-chunk character offset (default 0). A chunk exceeding max_chars serves a char-window and emits a char_offset cursor — pass it back with the same offset to read deeper. Ignored on normal chu |
| max_chunks | integer | no | Chunks per page (default 10, max 10) |
| query | string | no | Keyword to search within section chunks (e.g., 'customer concentration', 'export control'). Returns the chunks that contain every word (order-free); when none does, returns the closest chunks under a |
| include_companions | boolean | no | With section_id='item_1_01_material_agreement' on an 8-K anchor: also return text from same-day same-issuer companion 8-Ks (7.01 Reg FD + Ex 99 / 8.01). Default false = anchor only. |
| companion_accessions | array | no | Explicit companion accessions (from a screen_filing_signals row's value.companion_accessions). With include_companions=true, skips the discovery hop — halves the round-trips if you already scree |
| max_chars | integer | no | Soft response-size cap (default 20,000 chars). The anchor is always served in full; companions are appended in priority order and truncated with a follow-up-call marker. Raise only when you need wider |
| preview_chars | integer | no | Outline-mode preview length per section (default 120 ≈ 25 words). Ignored when section_id is provided. |
Use this when the user asks for a number the standard statements don't break out — revenue by segment, geography, product or customer, customer concentration, an industry metric (medical cost ratio, reserve replacement ratio) — or a figure exactly as filed in a 10-K / 10-Q. Searches the raw XBRL facts (~3,000 per filing, with dimensional breakdowns); for standard statements and the 250+ standard m
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'UNH', 'AAPL'). Must be exact. |
| search | string | yes | Search XBRL concepts by label or name. SPACES INSIDE A TERM ARE 'AND' — every word must appear somewhere in the fact's concept name, label, OR its dimension axis/member labels AS THE FILER WROTE THEM. |
| accession_number | string | no | Specific filing accession number (from list_filings — which takes vantage_date, so it gives the filing current as of a past date). If omitted, resolves automatically from form_type + fiscal_year (late |
| form_type | string | no | Filing type when auto-resolving (ignored if accession_number provided). Default: 10-K (annual). FPI filers: 20-F/40-F (annual) or 6-K (interim) — the backend auto-resolves the right form family, so th |
| fiscal_year | integer | no | Fiscal year to look up (e.g., 2022). If omitted, uses the latest filing. Ignored if accession_number provided. |
| fiscal_period | string | no | Pin the exact period when resolving by fiscal_year (Q1/Q2/Q3/Q4/FY). WITHOUT it, fiscal_year resolves to the LATEST filing of that year — wrong for 'as of <quarter>' questions (use this to get the rig |
| limit | integer | no | Maximum facts to return (default 50, max 200) |
| period_history | boolean | no | Return the searched concept's full as-filed series ACROSS filings (every period: quarter, 6-month YTD, 9-month YTD, FY) instead of one filing's facts. Use this to de-cumulate a cumulative cash-flow / |
Use this when the user asks what matters in a company's latest 10-K or 10-Q — red flags, accounting quality, debt and liquidity stress, top risks, management tone and guidance, segments and customer concentration. Returns the facts MetricDuck extracted from that filing, each with evidence and a pointer to the section to read next with get_filing_section(). Facts are presented neutrally; those from
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'AAPL'). Must be exact. |
| lens | string | no | Filter to a specific analytical view. earnings_quality: SBC dilution, accounting flags, material weaknesses, earnings quality assessments. debt_stress: Debt profile, covenant compliance, near-term mat |
| vantage_date | string | no | As-of vantage (YYYY-MM-DD): index the signal map for the latest filing filed ON OR BEFORE this date — for point-in-time / 'as of <date>' analysis (backtest, 'what was known at the announcement'). Omit |
Use this when the user asks which companies show a red flag or event across filings, earnings releases or earnings calls — "which companies lowered guidance?", "who has covenant risk or debt coming due?", "which tech companies sound cautious?", "who announced M&A or a partnership?" — or what has flagged for one company recently (ticker). Not metric screening (P/E, ROIC: use screen_companies). Mo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| signals | array | yes | Signal filters to match. Pass one or more ids EXACTLY as listed below (only these are screenable). Omit ticker to screen the whole universe for a signal (the common case); pass ticker only to chec |
| ticker | string | no | Filter to a single ticker (e.g. 'NVDA'). Use for per-ticker cross-source signal inventory. Omit to screen across all companies. |
| sectors | array | no | Sector codes: TECH, HEALTH, FIN, RE, CONS_DISC, CONS_STAPLES, IND, MAT, ENERGY, UTIL, TRANSPORT, COMM, OTHER |
| recency_days | integer | no | Only filings from last N days (default: 90) |
| limit | integer | no | Max results (default: 20) |
| match_mode | string | no | Match semantics within a source type. 'all' (default) = every requested signal fires on the SAME row (targeted screening); 'any' = at least one fires (broadcast discovery / digest pools). |
| order_by | string | no | Result ordering. 'recency' (default) = event_date/filing_date DESC; 'market_cap' = market-cap DESC NULLS LAST with a recency tiebreak — use it so high-impact filings aren't pushed past the limit by fr |
| since_date | string | no | Lower bound (inclusive, YYYY-MM-DD) on event_date / filing_date. With until_date, defines an explicit range that OVERRIDES recency_days — use for historical windows, backfilling past digests, or compa |
| until_date | string | no | Upper bound (inclusive, YYYY-MM-DD). With since_date, overrides recency_days. |
| agreement_type_filter | string | no | Discriminator for ir_partnership signals — e.g. 'm_and_a_announcement' for fresh M&A deals, 'partnership_strategic' for alliances. Ignored for non-IR signals. |
Search the full text of SEC filings since 2001 to find companies related to any concept — a product, technology, regulation, event, or company. Returns filing-level results with aggregated statistics (company count, form type breakdown, industry distribution). For 10-K/10-Q filings processed by MetricDuck, also shows WHICH SECTIONS contain the term with drill-in pointers. **Searchable form types
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | Search terms. All terms required by default (implicit AND). Syntax: exact phrase "revenue recognition", OR: "goodwill impairment" OR "asset writedown", NOT: restructuring NOT "restructuring charges", |
| ticker_lookup | string | no | RETIRED — returns a redirect. Scope with company; to find who MENTIONS a company, search its formal name with form_type. |
| form_type | string | no | SEC form type filter. 10-K (annual report), 10-Q (quarterly), 8-K (material events), DEF 14A (proxy/compensation), S-1 (IPO registration). Comma-separated for multiple: '10-K,10-Q'. Omit to search all |
| company | string | no | Restrict to one company. Accepts a ticker in capitals (e.g. 'WSC'; resolved to its CIK, so exact), a CIK (exact match — get from search_companies; shorter numeric CIKs are auto-zero-padded to 10 digit |
| date_from | string | no | Start date YYYY-MM-DD. Default: 1 year ago. For a HISTORICAL event (M&A announcement, lawsuit, restructuring, leadership change) set it before the event, with form_type='8-K' and rank_by='relevance': |
| date_to | string | no | End date YYYY-MM-DD. Default: today. |
| limit | integer | no | Max results (default 10, max 100). Results deduplicated by filing, sorted most recent first. Section-level enrichment applies to the first 5 results. |
| sections | boolean | no | Include section-level matches showing WHERE in each filing the term appears. Provides exact section + chunk pointers for immediate drill-in with get_filing_section. Set false for faster filing-level-o |
| rank_by | string | no | Sort order for the returned filing list. 'date' (default) = most recent filings first — best for time-sensitive queries (breaches, guidance changes, recent events). 'relevance' = EFTS native relevance |
8-K earnings-RELEASE financials — headline income statement (revenue, net income, operating income, diluted EPS) PLUS the as-released cash-flow statement (operating cash flow, capex, free cash flow, +growth), typically WEEKS before the audited 10-Q/10-K. Often the ONLY structured source for the fresh quarter's capex/OCF/FCF (the 8-K carries no XBRL, so get_financials/get_metric_history still show
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'NVDA'). Must be exact. |
| quarters | integer | no | Number of most recent quarters to return (1-8, default 4). |
| vantage_date | string | no | As-of vantage (YYYY-MM-DD): serve releases KNOWN on/before this date — the quarters walk back from the vantage instead of today. For backtests / point-in-time questions. Omit for the latest. Scope: th |
Did management deliver what they guided? Joins forward guidance from earnings-call transcripts to reported actuals from 10-K/10-Q + 8-K earnings for the same ticker + fiscal period. Returns both sides verbatim with quotes and locators. Use Cases: - "Did NVDA deliver on Q2 FY2026 guidance?" -> get_guidance_vs_actual("NVDA", fiscal_period="Q2 FY2026") - "How disciplined has MSFT been against its o
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'NVDA'). Must be exact. |
| fiscal_period | string | no | Target fiscal period, e.g. "Q2 FY2026". If omitted, defaults to the most recent period with SEC filing actuals, or to a newer quarter whose 8-K earnings release is out when guidance targets it. |
How has management's posture shifted across recent earnings calls? Cross-quarter trajectory view of transcript signals for a single ticker. This is MetricDuck's EARNINGS-CALL TRANSCRIPT tool (agents also look for this as get_earnings_call_transcript / get_earnings_transcript / get_earnings_call / search_earnings_calls). It aligns calls by event date and surfaces CROSS-QUARTER patterns; for ONE ca
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'NVDA'). Must be exact. |
| n_quarters | integer | no | How many most-recent earnings calls to compare (default: 4, min: 2, max: 8). |
| dimensions | array | no | Filter to specific trajectory axes; every axis is a per-quarter series. Omit for all. guidance: forward guidance items with delta_vs_prior. hedges: Q&A deflection rate. qa: Q&A Exchange Analyzer aggre |
| vantage_date | string | no | As-of vantage (YYYY-MM-DD): compare only calls reported ON OR BEFORE this date, window anchored there rather than today — don't assume the latest calls reflect a past vantage. Omit for the most recent |
Time series for one metric across fiscal periods. Returns newest-first rows labeled with the company's fiscal_year + fiscal_period — answer a period-specific question ("Q2 FY2025?") from those labels. The period_end calendar date is NOT the fiscal label, especially for non-December FYE companies (AAPL FY ends Sep; CRM FY ends Jan; ORCL FY ends May). Each row with an SEC accession is cited back to
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'AAPL'). Must be exact. |
| metric_id | string | yes | Exact metric id (lowercase + underscores). Common XBRL financials: gross_margin, oper_margin, net_margin, ebitda_margin, roe, roa, roic, pe_ratio, ev_ebitda, ev_sales, fcf_yield, pb_ratio, current_rat |
| period_type | string | no | Q = quarterly, FY = fiscal year, TTM = trailing 12 months. |
| window | integer | no | Max observations returned, newest first. Default 20, max 40. |
| vantage_date | string | no | As-of vantage (YYYY-MM-DD): restrict the series to periods whose ORIGINAL filing was published on or before this date, and cite the filing that was current then. Omit for the latest. IMPORTANT — this |
The DERIVATION of one COMPUTED metric — its human formula + immediate inputs (each value + source), one level at a time. The audit / verify affordance for derived figures (margins, ratios, ROIC, FCF, adj-EBITDA): call it ONLY when the query asks how a metric is computed, which definition MetricDuck used, or to verify / audit the derivation — NOT to get the value itself (use get_metric_
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'AAPL'). Must be exact. |
| metric | string | yes | Metric id of a COMPUTED metric (e.g. 'net_margin', 'roic', 'fcf', 'ev_ebitda'). |
| period_type | string | no | Q = quarterly, FY = fiscal year, TTM = trailing 12 months. |
| fiscal_year | integer | no | Pin the fiscal year (e.g. 2025). Omit for the latest period. |
| fiscal_period | string | no | Pin the fiscal period. Omit for the latest. |
| segment | string | no | Reporting segment id. Omit for the consolidated figure. |
Retrieve IR earnings-PRESENTATION-DECK text — forward guidance, operational KPIs, and segment outlook that are ONLY in the company's investor-relations slide deck and NOT in the SEC 8-K/10-Q release text or XBRL. Reach for this when get_metric_history / get_xbrl_facts have no series for a KPI or guidance figure, or the 8-K earnings release from get_filing_section lacks it (decks are a separate so
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | Company ticker symbol (e.g., 'OXY'). Required unless cik is provided. |
| cik | string | no | 10-digit SEC CIK as an alternative to ticker (e.g., '0000797468'). |
| fiscal_year | integer | no | Fiscal year of the deck (e.g., 2024). Narrows to one period when combined with fiscal_period. |
| fiscal_period | string | no | Fiscal period: 'Q3' (with fiscal_year) or combined '2024Q3'. Omit to return the latest deck(s). |
| query | string | no | Keyword filter over slide text — returns ONLY the deck pages whose text matches every word (whole-word AND, case-insensitive). Use this to pull a specific figure (e.g., query="production guidance", "b |
| mode | string | no | Response mode. 'full' (default): slide TEXT for the matched deck(s) — combine with query/period to pull a figure. 'list': a cheap one-row-per-item INVENTORY of the company's served IR documents (doc_k |
Retrieve a company's IR event CALENDAR — UPCOMING and PAST investor-relations events (earnings calls, annual/shareholder meetings, broker conferences, investor days) with the materials attached to each (deck, webcast, press release, transcript). Reach for this for calendar questions: - "When does {ticker} next report / hold its earnings call?" → the UPCOMING list (scheduled events) - "What IR eve
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'AAPL'). Required. |
Per-fiscal-period earnings DOCUMENT INDEX — one row per quarter/year gathering the documents for that reporting period: the 8-K press release, the earnings-call transcript (with prepared-remarks / Q&A deep-links), the 10-Q/10-K, the IR presentation deck(s), and the webcast event. Each artifact is present or honestly absent: the "what can I pull for this quarter, and how do I reach it" map. Reach
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | yes | Company ticker symbol (e.g., 'MRK'). Required. |
| limit | integer | no | Most-recent fiscal periods to return (newest first). Default 12. |
Use this when the user asks what SEC filings came out recently — "any new 10-Ks, 10-Qs or 8-Ks this week?", "which of my portfolio companies filed since Monday?", "who reported earnings today?" — across all companies or a list of tickers, in one call. Also the building block for alerts and daily portfolio checks. Returns: a flat list of {ticker, accession, filed_at, form_type, form_subtype},
| Parameter | Type | Required | Notes |
|---|---|---|---|
| since | string | yes | Filing date floor (inclusive): the SEC filing date, not the date MetricDuck extracted it. YYYY-MM-DD. Required. A small share of filings (mostly 8-K and 6-K exhibits) are extracted days or weeks after |
| form_types | array | no | Filter by SEC form type. Examples: ['8-K'], ['8-K', '10-Q'], ['10-K']. Omit to include all form types. |
| form_subtypes | array | no | Filter by 8-K sub-type derived from section inventory. '8-K-earnings' = earnings release; '8-K-transcript' = earnings call transcript; '8-K-event' = M&A / executive changes / debt; '8-K-other' = misc. |
| tickers | array | no | Optional portfolio filter. Up to 50 tickers. Omit to scan the full universe. |
| ticker | string | no | Single-ticker alias of tickers. Both may be given (union, cap 50). |
| limit | integer | no | Max results (default 50, max 100). Sorted newest filing date first, then by company size, so a small limit still surfaces the largest issuers that filed. |
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install MetricDuck — Financial Analysis or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
—Grade not published
No rule-by-rule report on file for this release
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 0.9.0.
0.9.0
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish MetricDuck — Financial Analysis can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.