Log inSubmit server
Esef Filings logo

Esef Filings

Search European and Ukrainian annual filings, then extract tagged IFRS facts from machine-readable XBRL reports.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Esef Filings

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "esef-filings": {
      "command": "npx",
      "args": [
        "-y",
        "@pipeworx/mcp-esef-filings"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Esef Filings MCP server searches the filings.xbrl.org index and selected national official disclosure sources for published annual reports. Its tools cover filing discovery, company filing histories, and extraction of IFRS facts from xBRL-JSON reports, including values, currencies, periods, and concepts. Use it to identify relevant ESEF or UAIFRS reports before retrieving financial figures, validation details, or official document links. The service is keyless and validates requested search filters rather than silently ignoring unknown arguments.

Use cases

  • Find annual reports by company, country, regime, or reporting period
  • List a company’s distinct annual reports across available language editions
  • Extract revenue, profit, assets, equity, or cash-flow facts from a filing
  • Identify filings with XBRL validation errors or warnings
  • Open the official HTML, viewer, package, or xBRL-JSON report

Key features

  • Searches ESEF and UAIFRS annual-report metadata
  • Resolves companies by name, LEI, or national identifier
  • Extracts tagged IFRS facts from xBRL-JSON
  • Supports exact and range-based reporting-period filters
  • Reports validation counts and filter verification details
  • Groups duplicate language editions into distinct reports

Tools3

What Esef Filings lets your agent do. Expand a tool for its parameters.

Verified live~4.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

9/9 checks healthy over the last 45d

What it can do

From the 3 tools this server returned when we ran it; 3 declare their own safety hints.

Makes network requests · 3Read-only tools · 3
Network at startup4 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age36 days
Maintainers1

Observed 2026-10-30 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · @pipeworx/mcp-esef-filings (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads1.3kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed3Callable tools this server registers over MCP.

How Esef Filings works

What Esef Filings does

Esef Filings provides MCP tools for finding published company annual reports and reading tagged financial data from those reports. Its main index covers two regimes: ESEF filings from European countries and UAIFRS filings from Ukraine. Results can include the company name, LEI or national identifier, country, reporting regime, reporting period, language, validation error and warning counts, source, publication time, and links to the machine-readable report, inline-XBRL document, viewer, or package.

The service is useful when an agent needs to answer questions such as which companies filed for a particular year, what reports a company has published, or what revenue, assets, equity, profit, cash flow, or earnings-per-share figures appear in a filing.

How it works

Use esef_search_filings to filter the filing index by company-name substring, ISO-2 country code, regime, calendar year, exact period end, or a period-end date range. The response includes the index-wide match count and records how the requested filters were applied and verified. Unknown argument names produce a user_error instead of being dropped.

Use esef_entity_filings when the starting point is a company name, LEI, or national registration number. It resolves the entity and returns its filing history, including how the match was made. Language editions of the same annual report are grouped into distinct reports, with the English edition preferred when available.

Use esef_filing_facts as the numbers step. It opens a filing's xBRL-JSON report and returns tagged IFRS facts with their value, currency, reporting period, and concept name. A filing can be identified with an fxo_id, or by company and optional year. Supplying a concept substring narrows the result; omitting it returns a headline selection and the report's concept inventory.

Tools and capabilities

  • esef_search_filings searches annual-report metadata and supports country, regime, year, period, validation-error, sorting, pagination, and date-range filters.
  • esef_entity_filings resolves a company identifier and lists its annual reports with grouped language editions.
  • esef_filing_facts reads financial facts from xBRL-JSON, including common statement figures and other tagged concepts.
  • Search and entity results provide direct links to machine-readable, HTML, viewer, and package resources when available.
  • Fact extraction collapses repeated identical taggings, separates consolidated totals from dimensional breakdowns, and exposes conflicting values rather than silently choosing between them.

Limitations and notes

The indexed scope contains approximately 25,640 filings across ESEF and UAIFRS; an unfiltered request can therefore include Ukrainian filings as well as European reports. Pin country or regime when the distinction matters. The index may lag the filing season, while several countries are queried directly from national OAMs or disclosure services to improve recent coverage.

Some live-lookup countries require an explicit country filter. Luxembourg, Slovenia, Estonia, Greece, Ireland, and Bulgaria have special lookup behavior, and certain results from those sources do not provide machine-readable xBRL-JSON for esef_filing_facts. Irish rows may lack an exact period end, Greek periods can be inferred from the reporting year, and Slovenian coverage is limited to roughly the most recent announcements.

A small portion of index rows lack a machine-readable report. In that case, fact extraction returns a not-found result with any surviving source URLs. Dimensioned facts are excluded by default, text-valued facts are clipped, and contradictory values are surfaced as conflicts. Period normalization also accounts for the one-day timestamp convention used by xBRL instant periods.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Esef Filings

Esef Filings is an MCP server that connects AI agents to the filings.xbrl.org index and selected official national filing sources. Its main tools search annual reports, list a company’s filing history, and read IFRS financial facts from machine-readable xBRL-JSON reports, including values, currencies, periods, concepts, validation counts, and document links.

Use `esef_search_filings` with filters such as `entity_name`, `country`, `regime`, `year`, `period_end`, `period_end_from`, or `period_end_to`. The response returns matching filing metadata, links, validation counts, match totals, and evidence that the requested filters were applied.

Call `esef_filing_facts` after identifying a filing with `esef_search_filings` or `esef_entity_filings`. Pass its `fxo_id`, or identify the company and optional year, then use `concept` to target terms such as `Revenue`, `ProfitLoss`, `Assets`, `Equity`, or `CashFlows`.

No, Esef Filings is keyless and requires no account. It makes limited requests to the index and uses a contactable user agent; national-source lookups may be performed directly for supported countries.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewEsef Filings AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/esef-filings?style=directory)](https://allmcps.com/mcp/esef-filings)
HTML Embed
<a href="https://allmcps.com/mcp/esef-filings"><img src="https://allmcps.com/api/badge/esef-filings?style=directory" alt="Esef Filings on AllMCPs" /></a>