Unofficial European Financial Filings MCP Server

A Model Context Protocol (MCP) server providing access to European company data and financial filings.

Data Sources

Source	Coverage	Data
GLEIF	1.6M+ EU companies	Company search, LEI lookup
ESEF (filings.xbrl.org)	FR, DK, GB, LT, UA	XBRL financial filings
UK Companies House	5M+ UK companies	Filing history, annual accounts
Curated Lists	DAX40, SIX, FTSE100	Major index companies

Usage

{
  "mcpServers": {
    "eu-filings": {
      "command": "node",
      "args": ["/path/to/eu-filings-mcp-server/build/index.js"],
      "env": {
        "UK_COMPANIES_HOUSE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`UK_COMPANIES_HOUSE_API_KEY`	For UK methods	Free API key from Companies House

API Methods

Company Search (GLEIF - All EU)

Search 1.6M+ European companies:

{
  "method": "search_companies",
  "query": "Siemens",
  "country": "DE",
  "limit": 10
}

Supported countries: FR, DE, IT, ES, NL, BE, AT, SE, DK, PL, GB, CH, and more.

Company by LEI

{
  "method": "get_company_by_lei",
  "lei": "YEH5ZCD6E441RHVHD759"
}

ESEF Filings (FR, DK, GB, LT, UA)

Get companies with ESEF filings:

{
  "method": "get_country_companies",
  "country": "FR",
  "limit": 10
}

Get filings for a company:

{
  "method": "get_company_filings",
  "lei": "969500YG7U0UQDEHBD60",
  "limit": 5
}

Extract XBRL financial data:

{
  "method": "get_filing_facts",
  "filing_id": "23209"
}

UK Companies House

Requires API key - Get one free at https://developer.company-information.service.gov.uk/

Search UK companies:

{
  "method": "search_uk_companies",
  "query": "Shell",
  "limit": 10
}

Get company profile:

{
  "method": "get_uk_company_profile",
  "company_number": "04366849"
}

Get filing history:

{
  "method": "get_uk_company_filings",
  "company_number": "04366849",
  "category": "accounts",
  "limit": 10
}

Get annual accounts:

{
  "method": "get_uk_company_accounts",
  "company_number": "04366849",
  "limit": 5
}

Curated Index Lists

DAX 40 (Germany):

{
  "method": "get_dax40_companies"
}

FTSE 100 (UK):

{
  "method": "get_ftse100_companies"
}

SIX (Switzerland):

{
  "method": "get_six_listed_companies"
}

Swiss Companies

{
  "method": "search_swiss_companies",
  "query": "Nestle",
  "limit": 5
}

{
  "method": "get_swiss_company_info",
  "lei": "549300U41AUUVOAAOB37"
}

All Available Methods

Method	Description	Data Source
`search_companies`	Search companies by name	GLEIF
`get_company_by_lei`	Get company by LEI	GLEIF
`get_country_companies`	Get companies with ESEF filings	ESEF
`get_company_filings`	Get filing history	ESEF
`get_entity_details`	Get entity details	ESEF
`get_filing_facts`	Extract XBRL data	ESEF
`get_filing_validation`	Get validation messages	ESEF
`filter_filings`	Filter filing results	ESEF
`get_dax40_companies`	DAX 40 companies	Curated
`search_swiss_companies`	Search Swiss companies	GLEIF
`get_swiss_company_info`	Swiss company details	GLEIF
`get_six_listed_companies`	SIX listed companies	Curated
`search_uk_companies`	Search UK companies	UK Companies House
`get_uk_company_profile`	UK company profile	UK Companies House
`get_uk_company_filings`	UK filing history	UK Companies House
`get_uk_company_accounts`	UK annual accounts	UK Companies House
`get_ftse100_companies`	FTSE 100 companies	Curated
`get_dimensional_facts`	Dimensional XBRL facts	ESEF
`build_fact_table`	Build fact table	ESEF
`search_facts_by_value`	Search facts by value	ESEF
`time_series_analysis`	Time series analysis	ESEF

Example: Get French Company Financials

// 1. Get French companies with filings
{ "method": "get_country_companies", "country": "FR", "limit": 5 }

// 2. Get company details
{ "method": "get_entity_details", "entity_id": "969500YG7U0UQDEHBD60" }

// 3. Get filings
{ "method": "get_company_filings", "lei": "969500YG7U0UQDEHBD60" }

// 4. Extract XBRL financial data
{ "method": "get_filing_facts", "filing_id": "23209" }

Limitations

ESEF Filings: Only available for FR, DK, GB, LT, UA
Germany: No public filing API - use DAX40 list + Bundesanzeiger manual lookup
UK: Requires free API key for Companies House methods
Switzerland: Company metadata only, no XBRL filings (not EU member)

License

MIT