Skip to content
Agentmart
Submit a tool

Bolsai MCP

Brazilian stock market data (B3, CVM, BCB) for AI assistants: quotes, fundamentals, dividends, FIIs.

Connector by viniciuslazzari · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 1
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/viniciuslazzari-bolsai-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Brazilian stock market data (B3, CVM, BCB) for AI assistants: quotes, fundamentals, dividends, FIIs.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
10 read · 0 write · 0 delete · 1 not yet classified
Secrets
1 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Python package

Tools by what they do 11

Read from the source code; the running server may list different tools.

Read 10 · Look things up without changing anything.

  • compare_stocks
  • get_dividends
  • get_fii_details
  • get_financial_statements
  • get_fundamentals
  • get_macro_indicator
  • get_price_history
  • get_stock_quote
  • list_sectors
  • search_companies

Not yet classified 1 · We could not tell from the name and description.

  • screen_stocks

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • BOLSAI_API_KEY

Tools (11)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • compare_stocks

    Compare fundamental indicators across multiple stocks side by side. Args: tickers: Comma-separated tickers, 2-5 (e.g. "PETR4,VALE3,ITUB4") metrics: Optional comma-separated metrics to show (e.g. "pl,pvp,roe,dividend_yield"). Available: pl, pvp, ev_ebitda, roe, roa, roic, net_margin, gross_margin, ebitda_margin, dividend_yield, close_price, lpa, vpa, debt_equity, p_sr

  • get_dividends

    Get dividend history with yield, annual summary, and individual payments. Works for both stocks and FIIs. FII tickers (ending in 11) are auto-detected. Args: ticker: Stock or FII ticker (e.g. PETR4, HGLG11) years: Years of history (1-20, default 3)

  • get_fii_details

    Get FII (Real Estate Fund) details: P/VP, dividend yield, NAV, and distributions. Args: ticker: FII ticker (e.g. HGLG11, KNRI11, MXRF11)

  • get_financial_statements

    Get raw CVM financial statements (income, balance sheet, cash flow). Args: ticker: Stock ticker (e.g. PETR4) statement_type: DRE (income), BPA (assets), BPP (liabilities), DFC_MI (cash flow), DVA (value added). Default: DRE. report_type: DFP (annual) or ITR (quarterly). Default: DFP. reference_date: Date (YYYY-MM-DD). Default: latest available.

  • get_fundamentals

    Get fundamental indicators: P/L, P/VP, EV/EBITDA, ROE, margins, debt ratios, and more. Returns 27+ indicators for Brazilian stocks. Uses the latest available data unless a specific reference_date is provided. Args: ticker: Stock ticker (e.g. PETR4, VALE3) reference_date: Optional date (YYYY-MM-DD) for historical snapshot

  • get_macro_indicator

    Get Brazilian macroeconomic indicator data. Args: indicator: One of: selic, selic_target, ipca, cdi, usd_brl, eur_brl limit: Number of data points (default 30)

  • get_price_history

    Get historical OHLCV stock prices with adjusted values for splits and dividends. Data available from 1986 to present. Args: ticker: Stock ticker (e.g. PETR4) start: Start date (YYYY-MM-DD) end: End date (YYYY-MM-DD) limit: Max data points (default 30, max 5000)

  • get_stock_quote

    Get the current stock price with daily change, 52-week range, and YTD return. Args: ticker: Brazilian stock ticker (e.g. PETR4, VALE3, ITUB4)

  • list_sectors

    List all available sectors with company counts. Use this to discover valid sector names for search_companies and screen_stocks.

  • screen_stocks

    Screen ALL Brazilian stocks by fundamental metrics. Scans ~264 companies in one call. Args: filters: Comma-separated filters like "pl_lt=15,roe_gt=10,dividend_yield_gt=5". Supported metrics: pl, pvp, ev_ebitda, roe, roa, roic, net_margin, gross_margin, ebitda_margin, dividend_yield, debt_equity, net_debt_ebitda, market_cap, lpa, vpa, current_ratio, p_sr, cagr_revenue_5y, cagr_earnings_5y. Use _gt (greater than) or _lt (less than) suffix. sector: Sector filter (e.g. "Bancos", "Energia Elétrica", "Petróleo e Gás") sort: Sort by met…

  • search_companies

    Search for Brazilian listed companies by name or sector. Use list_sectors first to see valid sector names. Args: query: Search term for company name (e.g. "Petrobras", "banco") sector: Filter by sector (e.g. "Bancos", "Petróleo e Gás", "Energia Elétrica")

Signals

Stars
1
Forks
0
Open issues
1
Weekly downloads
45
Last commit
Jul 7, 2026 (3 months ago)
Last release
Jul 7, 2026 (3 months ago)
Last package publish
Jul 7, 2026 (3 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.viniciuslazzari/bolsai-mcp
Version
0.1.4
Auth
API key
Packages
pypi bolsai-mcp
License
MIT
Repository
github.com/viniciuslazzari/bolsai-mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Bolsai MCP. Agent Mart. https://agentmart.dev/connectors/viniciuslazzari-bolsai-mcp (last updated 2026-10-24)