`esef_search_filings`

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

Search the XBRL International filings index (filings.xbrl.org) for published company annual reports. Answers “which European companies have filed an annual report for 2023”, “does Nokia have an ESEF filing”, “list Finnish filings with validation errors”. Returns per filing: company name, LEI or national identifier, country, reporting regime, period end, XBRL validation error/warning counts, report language, and direct links to the machine-readable xBRL-JSON, the inline-XBRL HTML report and the viewer. Filter by company name (substring), country (ISO-2), regime, period end date or calendar year.

Parameters

Name	Type	Required	Description
`entity_name`	string	no	Company name or fragment, case-insensitive substring match against the filer name (e.g. “Nokia”, “Citycon”, “Vodafone”, “Siemens”).
`country`	string	no	ISO-2 country of the filing jurisdiction: AT, BE, CY, CZ, DK, ES, FI, FR, GB, GR, IS, IT, LT, NL, NO, PL, PT, RO, SE (ESEF) or UA (UAIFRS).
`regime`	string	no	Reporting regime: “ESEF” for the European Single Electronic Format annual financial report, or “UAIFRS” for Ukrainian IFRS filings. Omit to search both.
`year`	number	no	Calendar year of the reporting period end, e.g. 2023. Matches any period ending in that year.
`period_end`	string	no	Exact reporting period end date, ISO format, e.g. “2023-12-31”. Takes precedence over `year`.
`with_errors`	boolean	no	Set true to return only filings that failed XBRL validation (error_count greater than zero).
`sort`	string	no	Result ordering: “newest” (most recently added to the index, the default), “oldest”, “period_desc” (latest reporting period first), or “period_asc”.
`limit`	number	no	Filings to return, 1-100. Default 20.
`page`	number	no	Page number for paging through a large match set, starting at 1. Default 1.

Example call

Arguments

{
  "entity_name": "Citycon",
  "country": "FI"
}

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_search_filings","arguments":{"entity_name":"Citycon","country":"FI"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('esef_search_filings', {
  "entity_name": "Citycon",
  "country": "FI"
});

More examples

{
  "country": "GB",
  "year": 2024,
  "sort": "period_desc",
  "limit": 10
}

{
  "regime": "UAIFRS",
  "year": 2021,
  "limit": 5
}

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_search_filings