EU Filings

Provides access to EU company data, ESEF filings, UK Companies House data, and curated index lists via MCP methods.

javascript

0

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run an MCP server that gives you access to European company data and financial filings from trusted sources, enabling quick searches, LEI lookups, and XBRL data extraction for analytics and compliance workflows.

How to use

You connect your MCP client to the EU Filings MCP Server to run searches, fetch company details, and obtain filings. Use the server to locate EU companies by name, retrieve company profiles by LEI, pull ESEF filings for FR, DK, GB, LT, and UA, and access UK Companies House data when you have a free API key. You can also explore curated lists like DAX40, FTSE100, and SIX to focus on major index constituents. Start by configuring a local MCP client to point at this server, then issue the supported methods one at a time as you build your workflow.

How to install

Prerequisites
  • Node.js 16+ (npm included)
  • Git (for cloning the repository)

Install and run the MCP server locally
  1) Clone the MCP server repository
     git clone https://example.com/openpharma-org/eu-filings-mcp-server.git
  2) Install dependencies
     cd eu-filings-mcp-server
     npm install
  3) Build the server (if a build step exists)
     npm run build
  4) Run the server locally
     UK_COMPANIES_HOUSE_API_KEY=your_api_key_here
     node build/index.js

Additional content

Configuration and usage details are provided below. Ensure you have a valid UK Companies House API key to access UK data. The server exposes a set of methods that you can call from your MCP client, covering search, details, filings, and XBRL data extraction across multiple data sources.

Configuration

Server connection is defined as a local runtime process that you start with Node. The following configuration enables the server and specifies the UK API key requirement.

Security and notes

Protect your UK API key and other credentials. Do not expose API keys in client-side code or public repositories. Use environment variable management practices to load secrets at runtime.

Troubleshooting

If the server fails to start, verify that Node.js is installed, dependencies are installed, and the UK API key is provided. Check the startup command and ensure the compiled build output exists at the expected path.

API overview and capabilities

The server offers a comprehensive set of methods to search and retrieve data across European sources. You can perform company searches, fetch by LEI, obtain ESEF filings, extract XBRL facts, and access UK filing histories when you provide the API key. Curated lists for DAX40, FTSE100, and SIX extend coverage to major index constituents, enabling targeted analyses.

Examples in usage

To get started, you will use methods such as get_country_companies to locate FR filings, then get_entity_details for a specific company, followed by get_company_filings and get_filing_facts to extract financial data.

Available tools

search_companies

Search 1.6M+ European companies by name with country scope.

get_company_by_lei

Retrieve company details using the LEI identifier.

get_country_companies

List companies with ESEF filings for a specified country.

get_company_filings

Fetch the filing history for a given company LEI or entity.

get_entity_details

Get detailed information about a specific entity.

get_filing_facts

Extract XBRL facts from a specific filing.

get_filing_validation

Retrieve validation messages for a filing submission.

filter_filings

Filter and refine filing results based on criteria.

get_dax40_companies

List DAX 40 component companies.

search_swiss_companies

Search Swiss companies by name.

get_six_listed_companies

List SIX-listed companies.

search_uk_companies

Search UK companies via Companies House data.

get_uk_company_profile

Fetch a UK company profile by company number.

get_uk_company_filings

Retrieve UK filing history for a company.

get_uk_company_accounts

Get UK annual accounts for a company.

get_ftse100_companies

List FTSE 100 companies.

get_dimensional_facts

Obtain dimensional XBRL facts from filings.

build_fact_table

Build a fact table from filing data.

search_facts_by_value

Search XBRL facts by their values.

time_series_analysis

Perform time series analysis on XBRL data.