io.github.viniciuslazzari/bolsai-mcp (MCP Server)

This MCP server provides Brazilian financial market data for AI assistants, querying information from B3, CVM, and BCB. It supports retrieval of stock quotes, fundamentals, dividends, FIIs, and macro indicators directly “from Claude.” Server metadata includes topics covering b3, brazil, claude, finance, mcp, mcp-server, model-context-protocol, and stocks.

🛠️ Key Features

Brazilian market data sourced from B3, CVM, and BCB
Queries for stock prices and quotes
Retrieval of fundamentals and dividends
FIIs and macro indicators support
Package name referenced as bolsai-mcp

🚀 Use Cases

Get up-to-date Brazilian stock market information in Claude
Support AI assistant workflows needing fundamentals and dividend data
Provide FII and macro context for analysis

⚡ Developer Benefits

Install via pip install bolsai-mcp
Configure in Claude Desktop with claude_desktop_config.json
Uses BOLSAI_API_KEY for API access

⚠️ Limitations

Source material does not specify tool count, supported methods, authentication details beyond an API key, or data update frequency.

Quick Start

Get a free API key at usebolsai.com

Install:

bash

pip install bolsai-mcp

Add to Claude Desktop (claude_desktop_config.json):

json

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

Or for Claude Code (.mcp.json):

json

{
  "mcpServers": {
    "bolsai": {
      "command": "bolsai-mcp",
      "env": {
        "BOLSAI_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Tools

Tool

Description

Example Prompt

get_stock_quote

Current price, daily change, 52w range

"What's PETR4 trading at?"

get_fundamentals

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

"Show me VALE3 fundamentals"

compare_stocks

Side-by-side comparison of up to 5 stocks

"Compare PETR4 vs VALE3 vs ITUB4"

get_dividends

Dividend yield, annual summary, payments

"What dividends did BBDC4 pay?"

search_companies

Find companies by name or sector

"Find banks listed on B3"

get_price_history

OHLCV prices since 1986 with adjustments

"PETR4 prices last month"

get_fii_details

FII fundamentals + distributions

"Show me HGLG11"

get_macro_indicator

SELIC, IPCA, CDI, USD/BRL

"What's the current SELIC rate?"

get_financial_statements

Raw CVM income/balance/cash flow

"PETR4 income statement 2024"

screen_stocks

Filter stocks by metrics

"Find stocks with DY > 8%"

Example Conversations

"What's PETR4 trading at?"

code

PETR4
Price: R$ 36.19
Change: +R$ 0.53 (+1.49%)
Date: 2024-12-30
52-week: R$ 28.44 – R$ 42.15
YTD: +12.34%

"Compare PETR4 vs VALE3"

code

Comparison: PETR4 vs VALE3

Metric              PETR4       VALE3
─────────────────────────────────────
P/L                  4.89        5.23
P/VP                 1.12        1.45
EV/EBITDA            3.21        3.87
ROE                33.20%      27.70%
Net Margin         24.50%      23.10%
DY                 12.30%       9.90%
Price           R$ 36.19    R$ 58.42

Environment Variable

Required

Default

Description

BOLSAI_API_KEY

Yes

—

API key from usebolsai.com

BOLSAI_BASE_URL

https://usebolsai.com/api/v1

API base URL

Install

Configuration

Environment variables

BOLSAI_API_KEYrequiredsecret

Your bolsai API key (free tier available at usebolsai.com)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

io.github.viniciuslazzari/bolsai-mcp