MCP server exposing 3 tools for brazil-cvm-financials.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/brazil-cvm-financials/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}br_financials — Annual financial statements (DFP) of a Brazilian listed company from CVM open data: balance sheet, income statement, cash flow and value added, as account lines with CVM account codes and Portuguese labels, in full BRL. Identify the company by cnpj (e.g. "00.000.000/0001-91" or 14 digits) or by name (e.g. "Petrobras"; an ambiguous name returns candidates instead of a guess). year is the fiscal reference year (default: latest loaded). scope is "consolidated" or "individual" (default: consolidated when the company filed one, else individual -- the response says which). Only the latest filing version is kept; the response states it. statement narrows to one of BPA (assets), BPP (liabilities and equity), DRE (income), DFC_MI / DFC_MD (cash flow indirect / direct), DVA (value added). max_depth (default 2) limits account-code depth so a default call returns the headline lines; raise it for sub-accounts. Results page with limit/offset and report truncated/total_matching. A company or year not in the data returns found:false with data_as_of, never an empty success.br_financials_search — Search Brazilian listed companies in the CVM annual-statements data by name (every word must appear; accents ignored), returning cnpj, name, CVM code and the fiscal years available. Use it to find the cnpj to pass to br_financials or br_financial_series. A query matching nothing returns found:false with data_as_of, never an empty list.br_financial_series — One CVM account across fiscal years for a Brazilian listed company -- e.g. account_code "3.01" for the income-statement top line, "1" for total assets, "2.03" for equity -- in full BRL with the account label, scope and filing version of each year. Pass cnpj or name. Account codes follow the CVM chart (1 assets, 2 liabilities and equity, 3 income statement, 6 cash flow, 7 value added); labels and meaning differ between banks/insurers and industrials, and the label is returned per year so a change is visible. Years the company did not file the account are listed in missing_years rather than dropped. A code the company never reported returns found:false with data_as_of.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/brazil-cvm-financials/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io