Bolsai MCP server | MCP Fair

Bolsai MCP server | MCP Fair

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx bolsai-mcp==0.1.4

Credentials from the publisher

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

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1BOLSAI_API_KEY=<secret> claude mcp add io.github.viniciuslazzari-bolsai-mcp -- uvx bolsai-mcp==0.1.4

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.viniciuslazzari-bolsai-mcp": {4      "command": "uvx",5      "args": [6        "bolsai-mcp==0.1.4"7      ],8      "env": {9        "BOLSAI_API_KEY": "<secret>"10      }11    }12  }13}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Server facts

Local

Transport: stdio
Version: 0.1.4
API key

Tools

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.viniciuslazzari-bolsai-mcp": {4      "command": "uvx",5      "args": [6        "bolsai-mcp==0.1.4"7      ],8      "env": {9        "BOLSAI_API_KEY": "<secret>"10      }11    }12  }13}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

From the publisher

Documentation

Bolsai - MCP Server

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

Quick Start

Get a free API key at usebolsai.com
Install:

pip install bolsai-mcp

Add to Claude Desktop (claude_desktop_config.json):

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

Or for Claude Code (.mcp.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?"

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"

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

Data Coverage

350+ stocks listed on B3
400+ FIIs (Real Estate Investment Funds)
40 years of price history (since 1986)
15+ years of fundamentals (since 2010)
27 indicators including P/L, P/VP, EV/EBITDA, ROE, ROIC, margins
Macro data: SELIC, IPCA, CDI, USD/BRL
Updated daily from official sources (B3, CVM, BCB)

Configuration

Environment Variable	Required	Default	Description
`BOLSAI_API_KEY`	Yes	—	API key from usebolsai.com
`BOLSAI_BASE_URL`	No	`https://usebolsai.com/api/v1`	API base URL

API Tiers

Free: 200 requests/day. Stock quotes, current fundamentals, company search.
Pro (R$ 49/month): 10,000 requests/day. All tools including history, dividends, financials, macro.

Development

cd mcp-server
pip install -e ".[dev]"
pytest
ruff check . && ruff format .

License

MIT