`esef_filing_facts`

Pack: esef-filings · Endpoint: https://gateway.pipeworx.io/esef-filings/mcp

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”. 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
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

esef_filing_facts