MCP.so
Sign In

Bolsai

@viniciuslazzari

RepositoryHomepage

About Bolsai

MCP server for bolsai — Brazilian stock market data (B3, CVM, BCB) for Claude, Cursor, and other AI assistants

#finance#stocks#brazil#b3#mcp-server#api#tools

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bolsai": {
      "command": "uvx",
      "args": [
        "bolsai-mcp"
      ],
      "env": {
        "BOLSAI_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Tools

10

Current price, daily change, 52w range

27+ indicators: P/L, P/VP, ROE, margins

Side-by-side comparison of up to 5 stocks

Dividend yield, annual summary, payments

Find companies by name or sector

OHLCV prices since 1986 with adjustments

FII fundamentals + distributions

SELIC, IPCA, CDI, USD/BRL

Raw CVM income/balance/cash flow

Filter stocks by metrics

Overview

What is Bolsai?

Bolsai provides Brazilian financial market data for AI assistants. It allows querying stock prices, fundamentals, dividends, FIIs, and macro indicators from the Brazilian market (B3, CVM, BCB) directly from Claude.

How to use Bolsai?

Obtain a free API key at usebolsai.com, then install the package with pip install bolsai-mcp. Add the server to Claude Desktop (claude_desktop_config.json) or Claude Code (.mcp.json) with the command uvx bolsai-mcp and set the environment variable BOLSAI_API_KEY to your key.

Key features of Bolsai

  • 10+ tools covering quotes, fundamentals, dividends, and FIIs
  • 27 financial indicators including P/L, P/VP, ROE, and margins
  • Covers 350+ stocks and 400+ FIIs listed on B3
  • 40 years of price history since 1986
  • 15+ years of fundamentals data since 2010
  • Macro indicators: SELIC, IPCA, CDI, USD/BRL

Use cases of Bolsai

  • Get a real-time stock quote with daily change and 52-week range
  • Compare up to five stocks side-by-side on key metrics
  • Search for companies by name or sector on B3
  • Screen stocks by criteria like dividend yield above 8%
  • Retrieve income statements or balance sheets for a given year

FAQ from Bolsai

Where do I get an API key?

Get a free API key at usebolsai.com. It is required to use the server.

What data sources does Bolsai use?

Data comes from official Brazilian sources: B3 (stock exchange), CVM (securities commission), and BCB (central bank). It is updated daily.

What are the rate limits and pricing tiers?

The free tier allows 200 requests per day for stock quotes, current fundamentals, and company search. Pro (R$ 49/month) permits 10,000 requests/day and unlocks all tools including history, dividends, and macro data.

Does Bolsai require any runtime dependencies?

It is a Python package. Install via pip (or uvx) and requires Python 3. The only required environment variable is BOLSAI_API_KEY.

How is authentication handled?

Authentication uses an API key passed as the BOLSAI_API_KEY environment variable in the server configuration. The key is issued at usebolsai.com.

Frequently asked questions

Where do I get an API key?

Get a free API key at [usebolsai.com](https://usebolsai.com). It is required to use the server.

What data sources does Bolsai use?

Data comes from official Brazilian sources: B3 (stock exchange), CVM (securities commission), and BCB (central bank). It is updated daily.

What are the rate limits and pricing tiers?

The free tier allows 200 requests per day for stock quotes, current fundamentals, and company search. Pro (R$ 49/month) permits 10,000 requests/day and unlocks all tools including history, dividends, and macro data.

Does Bolsai require any runtime dependencies?

It is a Python package. Install via pip (or uvx) and requires Python 3. The only required environment variable is `BOLSAI_API_KEY`.

How is authentication handled?

Authentication uses an API key passed as the `BOLSAI_API_KEY` environment variable in the server configuration. The key is issued at usebolsai.com.

Comments

Basic information

Category

Finance & Commerce

License

MIT

Transports

stdio

Author

viniciuslazzari

Submitted by

Vinícius Lazzari

More Finance & Commerce MCP servers

V

Velarion — Executive Compensation Intelligence

Velarion

Velarion exposes deterministic executive-compensation and governance intelligence for ~3,000 US public companies as callable MCP tools — sourced from SEC proxy filings, not LLM guesses. Nine tools: look up CEO/NEO pay an

SavePropTax

atifnayeem-oss

Check whether a California home qualifies for a Proposition 8 property tax reduction from recent comparable sales, then start a filing the owner completes themselves. Hosted remote server, no API key. Flat $29, paid by t

IBANforge

cammac-creator

IBANforge — IBAN validation, BIC/SWIFT lookup, Swiss clearing, and EMI/vIBAN classification API with MCP for AI agents

3

ApexVol Options Analytics

ryansilk

MCP server for ApexVol options analytics — options chains, IV rank, VRP, Greeks, GEX, expected moves, and screeners for Claude and any MCP client. Remote connector or pipx install; works with any paid ApexVol plan.

AuraNet Omni-Oracle Engine

Esdecy

15 sovereign, machine-payable intelligence oracles gated via x402 v2 on Base L2, Solana, and Tempo L1. Delivers high-velocity structured feeds for FDA biotech catalysts, SEC insider trades, prediction market arbitrage, a