Finance MCP vs Hub Equity MCP

find_entity

Search Hub-Equity entities by name, ticker (e.g. 'CSCO'), or CIK. Returns up to 5 matches ranked by exactness. Use this first when the user mentions a company by name or ticker - you need the entity_id to call any other tool.

get_fact

Get a normalized financial value for an entity at a given period. `hub_concept_code` is a Hub-Equity standardized code (e.g. 'REVENUE', 'NET_INCOME', 'TOTAL_ASSETS', 'OTHER_CURRENT_LIABILITIES'). Use `search_concept` first if you don't know the code. `fiscal_period_type` defaults to FY; the served values are annual, and another period type is refused with an error. When nothing is served for that combination, the call returns an error result that says so: never fill the gap with an estimate.

get_fact_decomposition

Decompose a financial fact into its constituent parts. Pass EITHER `hub_concept_code` (preferred - e.g. TOTAL_ASSETS) OR `qname` (raw XBRL like 'us-gaap:DeferredRevenueNoncurrent') for concepts without a hub mapping. Returns three layers: 1. `rollup_children` - the components this issuer reported for the figure, with their sign, on a paid plan; empty below it, with a note. 2. `linkbase_children` - XBRL calc linkbase children, RECURSIVE up to `depth` (max 3). Each child has its own `children` list. 3. `dimensional_breakdown` - axis/member slices (segment, geography), on a paid plan; empty below it, with a note. `depth=1` is open to every caller. On a paid plan, use `depth=2` for aggregates (TOTAL_ASSETS, TOTAL_LIABILITIES) to get the full breakdown tree in ONE call instead of N round-trips.

search_concept

Search Hub-Equity standardized hub concepts by code or label. Returns up to 10 matches. Use this when you don't know the exact `hub_concept_code`. Accepts plain English ('Costs and Expenses') and bare hub codes ('TOTAL_ASSETS').

list_hubs

List the catalog of standardized Hub-Equity hubs. Useful when you need to enumerate available metrics for a category (e.g. all balance-sheet hubs) without making N search_concept calls. Args: category: One of income_statement, balance_sheet, cash_flow, ratio, equity_info, metadata. Omit to list across all categories. include_non_primary: True to include derived/secondary hubs. limit: Cap (max 200, default 80).

get_entity_profile

Comprehensive company snapshot: identifiers, sector, auditor, employees, legal form, fiscal year end, recent filings summary. Use after `find_entity` when the user wants context, or as a first call when the user asks 'tell me about <company>' / 'qui est <entreprise>'.

get_metric_history

N-year time series for one metric (annual values only), with YoY growth (null across a missing year) and CAGR computed. Use for trend / growth questions: 'evolution of revenue over 5 years', 'CAGR du CF operating', 'Microsoft net income trend'.

get_segments

Dimensional breakdown of a metric (axis/member from XBRL dimensions). Use for 'revenue par région', 'profit by segment', 'split by product/geography'. Reads the dimensional (segment) values for the given period. Returns empty `axes` when the issuer reported only the consolidated total. The members of each axis need a paid plan: below it the axes are listed without them, with a note.

get_amendments

Surface 10-K/A restatements for an entity (per-concept diffs when available). Use when the user asks 'has X amended any filing?', 'restatements?', 'what changed in the FY20xx 10-K/A?'.

get_amendment_diff

Per-concept restatement diff (old_value, new_value, diff_pct, kind) across all 10-K/A amendments of an entity. Sorted by |diff_pct| desc. Differs from `get_amendments` (which returns counts per amendment): this tool flattens the per-concept changes and filters by materiality (`min_diff_pct`, default 1%) and optionally by hub_concept_code or kind. Use for 'what specifically changed in the FY24 10-K/A?', 'show all REVENUE restatements', 'material accounting corrections only'.

get_silent_restatements

Figures a later filing reprinted differently in its comparative columns, with no amendment filed, grouped by the filing that revealed them. The restatements `get_amendments` cannot see: most restatements are never filed as a 10-K/A or an amended ESEF report. `fiscal_year` is the year of the restated figure. `diff_pct` is in percent. Use for 'did X quietly change its past numbers?', 'restatements without an amendment', 'was FY2023 CapEx revised later?'.

get_silent_restatement_diff

Per-concept silent restatements (old_value, new_value, diff_abs, diff_pct, kind, label, both filings as sources), sorted by |diff_pct| desc. `get_amendment_diff` on the other source: figures a later filing reprinted differently in its comparative columns, with no amendment filed. Filters by materiality (`min_diff_pct`, a fraction, default 1%), hub_concept_code and kind (`modified`, or `added` for a newly disclosed figure). Use for 'all silent REVENUE restatements of X', 'material quiet revisions only', 'which filing revised FY2023 and by how much?'.