Cnmv Filings MCP server

@pipeworx/cnmv-filings

Spanish listed-company regulated disclosures and annual financial reports from the CNMV (Comisión Nacional del Mercado de Valores) public registers, including the ESEF report packages. Filings show up within minutes of registration, not months later as in the community ESEF index.

Part of Pipeworx — an MCP gateway connecting AI agents to 1678+ live data sources.

Tools

searches disclosures by publication window (Madrid calendar days, inclusive, default the last 7 days). You can narrow it to one issuer. It covers "Otra información relevante" (results, annual and half-year report notices, buybacks, governance) and "Información privilegiada" (inside information), newest first. Each row has the company, NIF, category, title, registration number, a Madrid-time publishedat and the document URL. totalcount is exact for the window.

• cnmvsearchfilings(datefrom?, dateto?, nif?, isin?, company?, feed?, limit?)

annual financial report register: financial-year end, publication date, auditor, audit opinion, the individual and consolidated report links, and the ESEF report package URL (a ZIP, sometimes named .xbri, holding the iXBRL report and taxonomy files, FY2020 onward).

• cnmvannualreports(nif? | isin? | company?, limit?) returns the issuer's

NIF that the CNMV registers use.

• cnmvfindissuer(company? | isin?) resolves a name or a Spanish ISIN to the

Why this pack exists

esef-filings proxies filings.xbrl.org. On 2026-09-23 that index held 113 Spanish filings for FY2024 and 1 for FY2025. The CNMV is the primary source the index aggregates from. Measured the same day: Técnicas Reunidas' FY2025 annual financial report was registered 2026-02-26 21:25 Madrid time, and its ESEF ZIP (5.5 MB, LEI 213800JEZBUPZKWJGF49) downloads from the URL cnmvannualreports returns. The newest OIR row in the register was 19:48 the same day it was queried.

⚠️ Things a caller must know

the ESEF package. esefpackageurl is there so a downstream pipeline can ingest it.

1. This is a document index, not an XBRL-facts API. Nothing here parses

without the dash, e.g. A39000013). ISINs and LEIs are not the register's key. isin is resolved through the CNMV ISIN register, which lists only securities issued in Spain. A foreign issuer listed in Madrid has an N… NIF and no Spanish ISIN, so use company or nif for those.

1. The issuer key is the Spanish NIF (e.g. A-28092583, sometimes written

including foreign-currency listings with codes like BRL-000356. The pack picks the closest domestic name and lists the rest under issuer_candidates. Check them if the name is ambiguous.

1. Name search can match several entities. "banco santander" matches six,

the +01:00/+02:00 offset. published_local is the raw string.

1. Timestamps are Madrid local time on the source. published_at carries

Auth

Keyless. No account, no API key. Everything is public on cnmv.es.

Data sources

is the "Otra información relevante" register, 10 rows per page, with a 0-based page.

"Información privilegiada" register and takes the same parameters.

• is the

annual financial report register for one issuer.

• is the

name search (an ASP.NET postback).

• is the entity

download handler (PDF / ZIP). These URLs stayed stable across page loads when tested.

• is the ISIN register.
• is the document

Gotchas

Shortened. The full README is on GitHub.