MCP App Store
by KeenEthics
Dados B3 icon

Dados B3 MCP Server for ChatGPT

By Lemon Tech (Dados B3)

Overview

Dados B3 provides fundamentals and market statistics for the ~450 companies listed on B3 (Brazil's stock exchange), banks and insurers included, from 2010 to today, plus market indices, ETFs and BDRs. Every figure carries the CVM account it came from, and the full methodology is public. Valuation multiples are priced at the first trading session on or after the filing became public, so there is no look-ahead. What you can ask: - Dividends and interest on equity per share for any listed ticker, with a yearly summary and the trailing 12-month dividend yield. - Performance of a stock or of a B3 index over any period: price return, total return with dividends reinvested, maximum drawdown and volatility. - A plain-language verdict on a company's latest year: does it make money, is it indebted, is it expensive against its sector and its own history. - ETF rankings, the list of BDRs that trade on B3, and the list of listed companies and indices. - What changed in the Brazilian market in the last 30 days, how current the data is, the methodology behind each metric, a data dictionary and a reproducible audit sample. Sources: CVM open data (ODbL) and B3 public end-of-day files. Dados B3 is an independent project by Lemon Tech and is not affiliated with, endorsed by or sponsored by B3 S.A. or the CVM. Read-only: the connector never places orders or moves money. It reports past measurements, not investment advice, and it has no real-time or intraday quotes. Method, data dictionary and examples: https://dadosb3.com/conector

How to connect

  1. ChatGPT: Open the Dados B3 listing in the ChatGPT app directory and choose Connect. ChatGPT listing Dados B3 exposes 28 tools here.

Tools

audit_sample

ChatGPT
Audit this database: draws indicator values at random and returns what you need to recompute each one against the ORIGINAL CVM file, not against us. You choose the seed (any integer); the draw is deterministic, so the same seed always returns the same cases and anyone can reproduce the result. Each case brings company, CVM code, fiscal year, indicator, published value, formula and the exact CVM account the company used that year. n is between 1 and 25. Report the denominator (divergences out of n), and do not turn "could not check" into "passed".

get_annual_indicators

ChatGPT
Yearly series (2010 to the latest fiscal year) of ROIC, ROE, gross, EBIT and net margins, revenue growth and net debt/EBITDA of a stock listed on B3, with quality flags, plus the provenance of each indicator (formula, CVM accounts, profit base). Stocks only: for a real estate fund (ticker ending in 11, such as HGLG11) use get_real_estate_fund. Banks and insurers come without ROIC and EBITDA, which do not apply to their chart of accounts. Works for any listed ticker.

get_bank_indicators

ChatGPT
Indicators of the banks listed on B3, from the Central Bank of Brazil IF.data (prudential conglomerate): Basel ratio, loans more than 90 days overdue, problem assets, loan book, net income and equity. No ticker: the LATEST quarter of each bank, ordered by loan book. With ticker (ITUB4, BBDC4, BBAS3, SANB11...): that bank's quarterly series. Central Bank numbers, not recomputed.

get_company_verdict

ChatGPT
Descriptive summary of a B3 stock in six numbers and three questions: does it make money (net margin, ROIC)? is it indebted (net debt/EBITDA)? is it expensive versus its sector and its own history (P/E, P/B)? Each number comes with its range and comparison with the sector median, the company's own history and the market; plus a confidence flag of the picture (green/yellow/red: was the statement restated? is the data current? did it pass the checks?). No judgment adjectives, no recommendation.

get_data_coverage

ChatGPT
How current and how large the database is: data version, first and latest trading session in the price series, date of the latest data load, and the number of companies, indicators, prices and ETFs.

get_data_dictionary

ChatGPT
Machine-readable methodology of every indicator: formula, CVM accounts used and the profit base of each one. Important to compare numbers correctly: net margin uses TOTAL consolidated profit; ROE uses profit attributable to the controlling shareholders.

get_dated_lists

ChatGPT
A ready-made ranking with its base date, the same one published on dadosb3.com/listas: list_name "dividends" (liquid stocks with the highest trailing 12-month dividend yield, one share class per company), "pe" (liquid stocks with P/E below 10) or "reits" (real estate funds with the highest 12-month yield). Empty returns the catalog of the three. limit is between 1 and 20 rows. Each answer brings the criterion, the rows, the source and the page to cite. Historical information only.

get_dividends

ChatGPT
Cash dividend history (dividends and JCP, interest on equity) of a company listed on B3: amount per share, approval date, record date (data-com) and price on that date, plus a yearly summary and the trailing 12-month dividend yield. Works for any listed ticker, e.g. PETR4, VALE3, ITUB4, BBAS3. The answer carries citacao, a ready-to-cite source line, and source_url, the public page.

get_electricity_tariffs

ChatGPT
Residential electricity tariff of each Brazilian distribution company, from ANEEL (electricity regulator) open data, since 2010: TUSD and TE in BRL/MWh, WITHOUT taxes, subgroup B1 conventional. No arguments: the latest tariff of each distributor, with the change against the previous adjustment and a summary (cheapest, median, most expensive). cnpj (14 digits) returns every tariff period of ONE distributor, cut by start_date/end_date (YYYY-MM-DD, start of validity). ticker is filled only when the distributor's CNPJ is that of a listed company.

get_etf_rankings

ChatGPT
ETFs listed on B3: most traded, largest net assets, largest discount and premium to NAV (price vs NAV per share of the SAME day), 12-month return by NAV (total return by construction) and lowest EFFECTIVE expense ratio (expenses from the fund's balance sheet over average net assets, annualized). Only liquid ETFs (over BRL 1 million/day) enter premium, return and expense rankings. Descriptive only.

get_financial_statements

ChatGPT
Standardized accounts of a stock listed on B3 (revenue, EBIT, net income, equity, debt, cash...), each number with the exact CVM account it came from, so it can be audited end to end. quarterly=False reads the annual statements (DFP); quarterly=True reads the quarterly ones (ITR, Q1 to Q3 isolated). The current version of each period. Stocks only. Works for any listed ticker.

get_growth_of_1000

ChatGPT
What BRL 1,000 invested in a stock, real estate fund or ETF listed on B3 became 1, 3, 5 and 10 years ago: price only and with distributions reinvested, against the Ibovespa (IFIX for real estate funds) and the Selic target rate, up to the latest close. The same numbers as the public page; for another period use get_stock_performance. No costs or taxes. Returns the text in Markdown.

get_index_performance

ChatGPT
Performance of a B3 market index (IBOV, IFIX, SMLL, IDIV, IBXX...) over a period: return, maximum drawdown and volatility of buy-and-hold and of a moving-average crossover (default 21 x 100). Default period: last 5 years. Use it as the benchmark when comparing a stock or a strategy. These are total return indices (B3 reinvests distributions in the points). Use list_indices for the available codes.

get_investment_funds

ChatGPT
Investment funds registered at CVM (fixed income, multimarket, equity, FX; about 25 thousand), from the CVM daily report: share value, net assets, shareholders and monthly inflows and outflows. No arguments: in the reference month, the limit largest funds by net assets and the largest net inflows and outflows. cnpj (14 digits): name, classification, manager and a 13-month series (the monthly share change is our computation, NOT the official return). search: by name or by the start of the CNPJ. limit is between 1 and 500.

get_market_today

ChatGPT
What changed in the Brazilian market in the last 30 days: financial statements made public (with the filing date at CVM), statements re-filed by the company, cash dividends approved, real estate fund distributions and reports, corporate events (splits, reverse splits, bonus issues) and ticker changes. Each section declares dados_ate, the latest date of that source.

get_material_facts

ChatGPT
The latest Material Facts (Fato Relevante) or market notices (Comunicado ao Mercado) that Brazilian listed companies filed at CVM, newest first, each with company, subject (the company's own text), filing date, protocol and the LINK TO THE ORIGINAL DOCUMENT at CVM. ticker filters by company (e.g. PETR4); category is "Fato Relevante" or "Comunicado ao Mercado"; limit is between 1 and 100. No summary or impact reading. CVM updates this open data WEEKLY and gives the date, not the time.

get_methodology

ChatGPT
The public methodology behind the numbers (formulas, CVM accounts, edge cases), in English. Without a topic, lists the available topics; with a topic (e.g. 'roic', 'dividendos', 'multiplos', 'margens'), returns the full text in Markdown.

get_oil_gas_production

ChatGPT
Oil and natural gas production in Brazil by operator and by field, from the ANP (national petroleum agency) open data. Average DAILY rate of the month: oil in bbl/day, gas in thousand m3/day. No arguments: the operators of the latest month, with share of the national total and year-over-year change. level="campo" returns fields; period (YYYY-MM) another month. cnpj (14 digits), operator (name at ANP) or field return the MONTHLY series, cut by start_date/end_date (YYYY-MM). From 2024 on coverage per field is PARTIAL: each row carries fonte and escopo. ticker is filled only when the operator's CNPJ is that of a listed company.

get_real_estate_fund

ChatGPT
Profile of a Brazilian real estate investment fund (FII) listed on B3, e.g. HGLG11, KNRI11, MXRF11: registration, latest monthly report (shareholders, net assets), point-in-time P/B history, current 12-month distribution yield, latest distributions and, for property funds, vacancy. Works for any listed FII.

get_real_estate_fund_rankings

ChatGPT
Brazilian real estate investment funds (FIIs): lowest P/B, highest 12-month distribution yield and the median P/B and yield by segment. Only liquid funds and clean values (no quality flag) enter. Descriptive only.

get_stock_performance

ChatGPT
Performance of a B3 stock over a period in a few numbers computed on the server: return, annualized return, maximum drawdown (with dates) and volatility of buy-and-hold, and the same for a moving-average crossover (default 21 x 100 sessions). Default period: last 5 years. Prices adjusted for splits and other corporate events; price return and, when dividends are recorded, total return with dividends reinvested. No costs or taxes. Dates as YYYY-MM-DD. Works for any listed ticker. A measure of the past only.

get_telecom_connections

ChatGPT
Mobile phone and fixed broadband connections (active lines and accesses) per operator, month by month, from Anatel (telecom regulator) open data. No arguments: the ranking of each service in the latest consolidated month, with share of the total and 12-month change. service (movel or banda_larga) + cnpj (14 digits, or TOTAL for all operators) returns the MONTHLY series of that operator, cut by start_date/end_date (YYYY-MM). Mobile excludes M2M. The newest month is preliminary. ticker is filled only when the operator's CNPJ is that of a listed company (e.g. VIVT3, TIMS3).

get_treasury_bonds

ChatGPT
Daily rates and prices of Brazilian Treasury bonds sold to individuals (Tesouro Direto), since 2004-12-31: the public yield curve by maturity. No arguments: every bond on the latest base date. bond (selic, prefixado, prefixado-juros, ipca, ipca-juros, renda-mais, educa-mais, igpm-juros) filters the family; date (YYYY-MM-DD) asks for the latest base date up to that day; bond + maturity (YYYY-MM-DD) returns the DAILY series of that bond, cut by start_date/end_date. Prefixado = NOMINAL rate per year; IPCA+, Renda+ and Educa+ = REAL rate above inflation; Selic = spread over Selic: nominal and real rates are not directly comparable.

get_valuation_multiples

ChatGPT
Point-in-time valuation multiples of a stock listed on B3: yearly P/E, P/B and EV/EBITDA, and quarterly trailing 12-month P/E, each priced at the first trading session AFTER the statement became public at CVM, so there is no look-ahead. Stocks only: for the P/B of a real estate fund use get_real_estate_fund. Works for any listed ticker.

list_bdrs

ChatGPT
List BDRs (Brazilian depositary receipts of foreign stocks and ETFs, e.g. AAPL34, NVDC34, IVVB39) that traded on B3 in the last year, most liquid first, with type, last close and average daily volume. bdr_type filters: DRN (unsponsored), DR1/DR2/DR3 (sponsored level I/II/III), DRE (ETF BDR). limit is between 1 and 1000 (default 100). Descriptive only.

list_companies

ChatGPT
List the Brazilian publicly listed companies (stocks only, not real estate funds), with CVM code, name and main B3 ticker when there is one. Use it to find the ticker of a company before calling the other tools. The count comes in the answer.

list_delisted_companies

ChatGPT
Companies that LEFT the Brazilian stock exchange (stopped trading on B3), by year of the LAST trading session: those whose public company registration was cancelled at CVM (with CVM date and reason) and those that stopped trading with the registration still active (move abroad, merger, tender offer). No year: the 3 latest years. With year: only that year (within those 3).

list_indices

ChatGPT
List the B3 market indices available (IBOV, IFIX, SMLL, IDIV...), with name, number of sessions and the first and last date of each series. Use the code with get_index_performance.

Capabilities

Read

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/dados-b3"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/dados-b3)