Brazil Cvm Financials MCP server

@pipeworx/brazil-cvm-financials

Annual financial statements (balance sheet, income statement, cash flow, value added) of Brazilian listed companies, from CVM (Comissao de Valores Mobiliarios) open data -- by CNPJ or company name, with CVM account codes and labels, in full BRL.

Part of Pipeworx — an MCP gateway connecting AI agents to 1872+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

-- the statements of one company for one fiscal year as account lines (code, Portuguese label, value in BRL). Default depth 2 returns the headline lines; raise maxdepth for sub-accounts. States the scope (consolidated/individual), the filing version and the filed scale on every response. A company or year not in the data returns found:false with dataas_of.

• brfinancials(cnpj | name, year?, scope?, statement?, maxdepth?, limit?, offset?)

must match, accents ignored); returns CNPJ, CVM code and the fiscal years available.

• brfinancialssearch(name, limit?) -- find companies by name (every word

-- one account across years (e.g. 3.01 income-statement top line, 1 total assets, 2.03 equity), with the label, scope and filing version of each year, and missing_years listed rather than dropped.

• brfinancialseries(cnpj | name, accountcode, fromyear?, to_year?, scope?)

Auth

Keyless.

Data sources

statements (DFP) of listed companies, fiscal years 2019 onward.

• CVM (Comissao de Valores Mobiliarios, Brazil), open data -- annual financial

Licence. CVM publishes this dataset under the Open Data Commons Open Database License (ODbL). The data here is a database copy, so ODbL applies to it: attribution to CVM and share-alike on the database. Every response carries the source and licence fields.

What is in the copy, and what is not -- read before quoting a number.

filing as extra rows (and are refreshed weekly with re-filings). Only the highest version per company + reference date is kept; the response reports filingversion and filingversions_seen. Superseded revisions are not available.

• Latest filing version only. CVM's archives carry every revision of a

comparative; that column is dropped (it is restated data that appears as the current column of the next year's own filing). So a figure is "as filed for that fiscal year", not "as restated later".

• Current-year column only. Each filing also reports the prior year as a

(BPP), income statement (DRE), cash flow indirect (DFCMI) and direct (DFCMD), value added (DVA), consolidated and individual. Not kept: statement of changes in equity, comprehensive income, auditor opinions, share-capital composition.

• Statements kept: balance sheet assets (BPA) and liabilities/equity

The default is consolidated where the company filed one.

• Scope: consolidated is the group; individual is the parent company alone.

response applies the multiplier and returns full BRL, naming the filed scale. All loaded statements are in BRL.

• Scale and currency: filers state values in units or thousands; the

2 liabilities and equity, 3 income, 6 cash flow, 7 value added) but banks and insurers use a different income-statement chart: 3.01 is revenue for an industrial and financial-intermediation income for a bank. The label comes back with every value so a mismatch is visible.

• Charts differ by sector. CVM account codes follow one numbering (1 assets,

and are NOT multiplied by the filed scale; they come back as valuebrlper_share.

• Per-share lines: earnings-per-share accounts (3.99.*) are BRL per share

year-end is listed under the calendar year of its reference date.

• Fiscal-year labels follow the reference date; a company with a non-December

Updating the data

Shortened. The full README is on GitHub.