plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "dados-b3",
  "version": "1.0.2",
  "description": "Read-only access to fundamentals, dividends, total-return performance, indices, ETFs and BDRs for companies listed on B3 (Brazil's stock exchange). Every figure cites its CVM source.",
  "author": {
    "name": "Lemon Tech (Dados B3)",
    "email": "contato@dadosb3.com",
    "url": "https://dadosb3.com"
  },
  "homepage": "https://dadosb3.com",
  "keywords": [
    "brazil",
    "b3",
    "stocks",
    "fundamentals",
    "dividends",
    "etf",
    "bdr",
    "cvm"
  ],
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "interface": {
        "displayName": "Dados B3",
        "shortDescription": "Brazilian stock fundamentals",
        "longDescription": "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.\n\nEvery 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.\n\nWhat you can ask:\n- Dividends and interest on equity per share for any listed ticker, with a yearly summary and the trailing 12-month dividend yield.\n- Performance of a stock or of a B3 index over any period: price return, total return with dividends reinvested, maximum drawdown and volatility.\n- 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.\n- ETF rankings, the list of BDRs that trade on B3, and the list of listed companies and indices.\n- 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.\n\nSources: 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.\n\nMethod, data dictionary and examples: https://dadosb3.com/conector",
        "developerName": "Lemon Tech (Dados B3)",
        "category": "Finance",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://dadosb3.com",
        "supportURL": "https://dadosb3.com/sobre",
        "privacyPolicyURL": "https://dadosb3.com/privacy",
        "termsOfServiceURL": "https://dadosb3.com/terms",
        "defaultPrompt": [
          "How much did Petrobras (PETR4) pay in dividends per share in 2025?",
          "What was the total return of VALE3 over the last 5 years, with dividends reinvested?",
          "Give me a plain-language verdict on WEG (WEGE3) from its latest annual numbers."
        ],
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Dividends per share for a listed ticker",
              "prompt": "How much did Petrobras (PETR4) pay in dividends per share in 2025?",
              "tools_triggered": "get_dividends",
              "expected_behavior": "Calls get_dividends with ticker PETR4 and answers from the yearly summary: R$ 3.27 per PN share in 2025 (13 payments: about R$ 1.52 in dividends, R$ 1.72 in interest on equity and R$ 0.04 in other income), gross before income tax on interest on equity. Cites the source returned with the result and states that it is historical data, not investment advice."
            },
            {
              "description": "Total return of a stock over the default five-year window",
              "prompt": "What was the total return of VALE3 over the last 5 years, with dividends reinvested?",
              "tools_triggered": "get_stock_performance",
              "expected_behavior": "Calls get_stock_performance with ticker VALE3 and the default five-year window (1,249 sessions, 2021-10-15 to 2026-10-16 in the 2026-10-01 data version). Reports a buy-and-hold price return of about -17.9% and a total return with dividends reinvested of about 24.4% (about 4.5% a year), with a maximum drawdown of about -53% on price (about -38% on total return). Explains that total-return fields include dividends and interest on equity, and that this is a past measurement, not a recommendation."
            },
            {
              "description": "Plain-language verdict on a company's latest year",
              "prompt": "Give me a plain-language verdict on WEG (WEGE3) from its latest annual numbers.",
              "tools_triggered": "get_company_verdict",
              "expected_behavior": "Calls get_company_verdict with ticker WEGE3 and relays the top line for fiscal year 2025: net margin 16.6%, ROIC 38.5%, net cash, P/E 33.1 against a sector median of 23.2, no relevant restatement. Organizes the answer around the three questions returned (does it make money, is it sound or indebted, is it expensive or cheap relative to the sector and its own history) and states that it is descriptive historical data, not advice."
            },
            {
              "description": "Index performance used as a benchmark",
              "prompt": "How did the Ibovespa (IBOV) perform over the last 5 years, including its worst drawdown?",
              "tools_triggered": "get_index_performance",
              "expected_behavior": "Calls get_index_performance with index IBOV and the default five-year window (2021-10-15 to 2026-10-15). Reports a buy-and-hold return of about 78.2% (about 12.3% a year), a maximum drawdown of about -20.9% between 2022-04-01 and 2022-07-14, and annual volatility of about 17.7%. Notes that the index is a total-return index, so dividends are already included, and that the figures are past measurements."
            },
            {
              "description": "BDR listing ordered by liquidity",
              "prompt": "Which BDRs trade the most on B3? Show me the top 5.",
              "tools_triggered": "list_bdrs",
              "expected_behavior": "Calls list_bdrs with limit 5 and returns the five most liquid BDRs, most liquid first, each with ticker, type (for example DRN unsponsored or DR3 sponsored level III), last close and average daily volume. In the 2026-10-16 data the list starts with ROXO34 (Nu Holdings), AURA33, MUTC34, NVDC34 and XPBR31. Mentions that liquidity is the average of the last 60 trading sessions and that the list is descriptive, not a recommendation."
            }
          ],
          "negative": [
            {
              "description": "Buy or sell recommendation. Dados B3 only measures the past, so the assistant should decline to say what to buy and may offer historical data (for example dividends or performance of a ticker the user names) instead. It should not call a tool to build a recommendation.",
              "prompt": "Which Brazilian stock should I buy this week to make the most money? Just give me one ticker."
            },
            {
              "description": "Real-time or intraday quote. The connector only has end-of-day data, so the assistant should say it has no live quote and must not present an end-of-day close as the current price.",
              "prompt": "What is PETR4 trading at right now? Give me the live price and today's intraday high and low."
            },
            {
              "description": "Ticker that does not exist. The tool returns an error (isError true, 'Unknown ticker XXXX3: no listed company found'); the assistant should relay that the ticker was not found, suggest checking it or listing companies, and must not invent dividends or any other figure.",
              "prompt": "How much did XXXX3 pay in dividends last year?"
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://dadosb3.com/demo/chatgpt"
      },
      "publication": {
        "release_notes": "Dados B3 connector: 13 read-only tools covering B3-listed company dividends, total-return performance of stocks and indices, plain-language company verdicts, ETF rankings, BDRs, market changes, methodology and an audit sample. Independent project, not affiliated with B3 S.A. or the CVM."
      },
      "apps": "./.app.json"
    }
  }
}