`esef_filing_facts`

Pack: esef-filings · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/esef_filing_facts for the schema, then POST the same URL with its arguments for the data.

Read the actual IFRS financial facts out of one published annual report — revenue, profit or loss, total assets, equity, operating cash flow, earnings per share and every other tagged figure, with the currency, the exact reporting period and the XBRL concept name. This is the numbers hop: esef_search_filings and esef_entity_filings prove a filing exists, this one opens its machine-readable xBRL-JSON report and returns what the company reported.

Parameters

Name	Type	Required	Description
`fxo_id`	string	no	Filing identifier from esef_search_filings or esef_entity_filings, e.g. “549300P8N0P6KDGTJ206-2022-12-31-ESEF-FI-0”, “cmvm-1355933” for a Portuguese filing read from CMVM, “cnmv-20912” for a Spanish filing read from CNMV, “newsweb-668785-321602” for a Norwegian filing read from Oslo Børs NewsWeb, “fi-61807” for a Swedish filing read from Finansinspektionen, “fsma-5c08f790-404c-4121-bd0b-0cf3350455da” for a Belgian filing read from FSMA STORI, “mse-BOV_20251231_CON_AFR_529900RWC8ZYB066JF16_20260326114707204” for a Maltese filing read from the Malta Stock Exchange OAM, “hanfa-1214588” for a Croatian filing read from HANFA SRPI, “mnb-909016” for a Hungarian filing read from the MNB, “oamlt-468051-338788” for a Lithuanian filing read from oam.lt, “asf-SNP-20260319180945” for a Romanian filing read from the ASF OAM, “cse-222818-223858” for a Cypriot filing read from the Cyprus Stock Exchange OAM, or “csri-24777-1” for a Latvian filing read from CSRI. Most precise way to name a filing.
`entity`	string	no	Company name, LEI, or national registration number, used when no fxo_id is available. Combine with `year` to choose a financial year; the latest English-language edition is preferred.
`year`	number	no	Calendar year of the reporting period end, e.g. 2023. Used with `entity`. Omit for the most recent filed period.
`concept`	string	no	Case-insensitive substring of the IFRS concept name to return, e.g. “Revenue”, “ProfitLoss”, “Assets”, “Equity”, “CashFlowsFromUsedInOperatingActivities”, “EarningsPerShare”. Omit for the headline projection.
`include_dimensioned`	boolean	no	Set true to also return facts broken down by an XBRL axis — per segment, per equity component, per class of asset. Default false, which returns consolidated group totals only.
`limit`	number	no	Facts to return, 1-500. Default 60.

Example call

Arguments

{
  "entity": "Citycon",
  "year": 2022
}

curl

curl -X POST https://gateway.pipeworx.io/esef-filings/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"esef_filing_facts","arguments":{"entity":"Citycon","year":2022}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('esef_filing_facts', {
  "entity": "Citycon",
  "year": 2022
});

More examples

{
  "fxo_id": "549300P8N0P6KDGTJ206-2022-12-31-ESEF-FI-0",
  "concept": "ProfitLoss"
}

{
  "entity": "Vodafone",
  "concept": "Assets",
  "limit": 10
}

{
  "entity": "Jeronimo Martins",
  "year": 2025,
  "concept": "Revenue",
  "limit": 5
}

{
  "fxo_id": "cmvm-1355933",
  "concept": "ProfitLoss",
  "limit": 5
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the esef-filings pack

{
  "mcpServers": {
    "esef-filings": {
      "url": "https://gateway.pipeworx.io/esef-filings/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

esef_filing_facts