Skip to main content
Glama
deenesjakoptruzh
vinibeni2801

mcp-mercado-financeiro-brasil

by vinibeni2801
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcp-mercado-financeiro-brasil

🚧 Under construction (Phase 1). Project under active development — the tools API and the source catalog may still change. Use with caution and follow the roadmap below.

MCP (Model Context Protocol) server that connects AI assistants (Claude Desktop, Claude Code, Cursor, Windsurf) to Brazilian financial market data via public sources. No-registration core, async, with caching and graceful degradation.

WARNING: informational/educational content. Not investment advice. Past performance does not guarantee future results.

Tools (Phase 1)

Module

Tools

indicators

get_selic, get_cdi, get_ipca, get_igpm, get_poupanca, get_serie_sgs, rentabilidade_real

exchange

get_cotacao (PTAX), historico_cambio

fixed_income

listar_titulos_tesouro, get_titulo_tesouro, simular_tesouro

calculators

juros_compostos, converter_taxa, rentabilidade_vs_cdi, imposto_renda_renda_fixa

meta

health_check, fontes_de_dados

Sources: BACEN SGS, BACEN PTAX (Olinda), Tesouro Transparente — all without a key. Stocks/FIIs (brapi.dev) and crypto (CoinGecko) arrive in phases 2/3 as optional via token.

Related MCP server: mcp-meelion

Installation

# execução efêmera (recomendado)
uvx mcp-mercado-financeiro-brasil

# ou permanente
pip install mcp-mercado-financeiro-brasil

Claude Desktop / Cursor

{
  "mcpServers": {
    "mercado-financeiro-brasil": {
      "command": "uvx",
      "args": ["mcp-mercado-financeiro-brasil"]
    }
  }
}

Development

uv sync --extra dev
uv run pytest          # testes unitários (mockados)
uv run pytest -m integration  # testes que batem nas APIs reais
uv run ruff check .
uv run mypy src

Environment variables (optional)

Variable

Default

Usage

MCP_MFB_LOG_LEVEL

INFO

Log level

MCP_MFB_HTTP_TIMEOUT

20

HTTP timeout (s)

MCP_MFB_CACHE_TTL

300

Cache TTL (s)

MCP_MFB_BRAPI_TOKEN

—

Enables stocks/FIIs (phase 2)

MCP_MFB_COINGECKO_KEY

—

Enables crypto (phase 2)

License

MIT

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
B
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Tesouro Direto MCP Server

    AtilioA
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language access to Brazilian treasury bond data through the Tesouro Direto API. Query market data, bond details, and search bonds by type, maturity, and other criteria.
    29
    5
    AGPL 3.0
  • mcp-meelion by Meelion-com

    mcp-meelionofficial

    Meelion-com
    F
    license
    Not graded
    quality
    D
    maintenance
    Meelion MCP ) connects AI assistants and automated clients to Meelion's structured data: a Brazilian platform for researching, comparing, and tracking investments, focusing on fixed income, indicators (Selic, CDI, IPCA, savings) and exchange rates (dollar, euro, gold, silver, Bitcoin).
    2

  • Banco MCP

    douglac
    A
    license
    Not graded
    quality
    D
    maintenance
    Connects Brazilian banks (Itaú, Bradesco, Nubank, etc.) to AI agents, enabling natural language queries about expenses, statements, investments, and credit cards via regulated Open Finance.
    19
    MIT

View all related MCP servers

Related MCP Connectors

  • Meelion MCP

    Brazilian fixed income & financial data for AI. Selic, CDI, IPCA, CDB/LCI/LCA rankings, FX rates.

  • Losbeto — Market Data for AI Agents

    Cross-asset market data for AI agents: forex, equities, Brazil macro (BCB/B3), crypto.

  • Sicoob MCP

    Connect your Sicoob account to AI via Brazil's Open Finance: balances, statements, cards, investment

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vinibeni2801/mcp-mercado-financeiro-brasil'

If you have feedback or need assistance with the MCP directory API, please join our Discord server