Read a public MFM record
fetchRead one numbered part of a published MFM document or dataset (an id returned by search that starts with "portfolio:" recomputes the portfolio calculator, nothing stored). Company metadata includes verification_level, audit_id, audit_url and controls_performed. metadata.next_id identifies the following part or is null. Audit levels describe programme membership. Company records: amounts are whole units of the currency stated in each period (field currency), never thousands or millions; ratios in metrics are decimals (0.15 = 15%) except years_* (years), interest_coverage, cash_conversion, capex_to_depreciation and debt_to_equity* (multiples, 1.5 = 1.5 times). years are in ascending order: the latest fiscal year is the LAST element, in the last parts, so follow every next_id before answering. ttm, quarters and interim_reports are separate periods with their own end dates; latest_interim names the most recent interim period and the block that holds it: use that one and never annualise. A null metric has its reason in warnings of the same period; an absent key is not zero. P1 v3: reason recorded in the source language; see audit (figures in the source: 1; 3); pe.ttm_fine and pe.eps_ttm identify the actual earnings period and EPS. pe.ttm_reason_en explains a missing TTM ratio. Always state both the price date and the earnings period beside every P/E; fiscal-year P/E is not TTM P/E. The pe block holds the P/E shown on the site, with the month-end price, its date and currency, earnings per share and the method (pe_latest null = not computed, reason in reason_en; pe_at_price = P/E on the latest fiscal year closed by the price date, rule P1 in pe.rule, with fiscal_year_at_price and note_en; date_price = date of the month-end price, never before the fiscal year end); other price-based figures (market value, dividend yield) are not in the record. public_float is the aggregate market value of shares held by non-affiliates declared on the cover of the annual report (SEC: at the end of the second fiscal quarter), not the current market capitalisation; public_float_info gives its date, filing and definition. Two rows with the same fiscal_year (change of year-end) are told apart by period_label. When retained_card_en is present, the record is retained and no longer updated by the computation: state since when, why and the last financial year before using its figures. A period with different_scope belongs, wholly or for the listed items (field items), to a different entity (shell, SPAC, reverse-merger predecessor, divested scope): say so, use its en text and do not compare it with later periods. Descriptive data only: no forecast, no recommendation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "fetch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | An id returned by search or list_datasets (company, page or dataset), the metadata.next_id of the previous part, "user-proposal:<id>" for the separate User Register, "quota" for the account allowances, or a "portfolio:" id returned by search. Also "market:US" (one whole market of the open data) or a "plan:" id returned by search. | |
| model_id | No | Optional identifier of the model used for the inspection; client-declared, not model attestation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| url | Yes | ||
| text | Yes | ||
| title | Yes | ||
| metadata | No |