Btg MCP Server - install, status & alternatives [2026]

01 · Install Btg

before you install - you'll need

Set BTG_CLIENT_ID, BTG_CLIENT_SECRET, BTG_CERT_PATH, BTG_KEY_PATH, MCP_HTTP before connecting. BTG_ENV is optional or environment-specific per the README.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-banking- -- npx -y @codespar/mcp-btg

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-banking-": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-btg"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-btg - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Btg can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create an immediate Pix charge (cob) with QR code, retrieve an immediate Pix charge (cob) by its txid, retrieve a boleto by its BTG identifier (id or nosso_numero), and retrieve the available balance for a BTG+ checking account (conta corrente).

Capability map

Tools grouped from the project's README - what Btg lets an agent do.

read & search

4 tools - e.g. Mint or return a cached OAuth2 client_credentials bearer token for the BTG Developer Portal.; List the counterparty's investment positions held at BTG, scoped to fixed-income asset classes (CDB, LCI…

get_oauth_token · list_investment_positions · get_portfolio_summary · list_funds_available

Pix

2 tools - e.g. Create an immediate Pix charge (cob) with QR code.; Retrieve an immediate Pix charge (cob) by its txid.

create_pix_cob · get_pix_cob

Boleto

2 tools - e.g. Issue a boleto via BTG Cobrança.; Retrieve a boleto by its BTG identifier (id or nosso_numero).

create_boleto · get_boleto

Account

2 tools - e.g. Retrieve the available balance for a BTG+ checking account (conta corrente).; Retrieve account statement transactions for a given period.

get_account_balance · get_account_statement

Subscribe

1 tool - e.g. Subscribe (aplicar) to a fund on BTG's distribution platform.

subscribe_to_fund

Redeem

1 tool - e.g. Redeem (resgatar) from a fund.

redeem_from_fund

Limitations (from the README)

- Paths are unverified. See the TODO(verify) markers in src/index.ts. Onboarded counterparties should validate against their portal-issued OpenAPI spec and open a PR. - Sandbox host is a guess. BTG issues a sandbox subdomain per counterparty; override by editing BASE_URL if your provisioned sandbox URL differs. - Investments surface (CDB/LCI/LCA/debêntures/funds) is differentiated vs. retail-bank MCPs in this repo, b

04 · Who maintains Btg

mcp-btg is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: security - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-btg (active, first published 2026-06-20 · 2 versions)
packages: npm:@codespar/mcp-btg

06 · Btg FAQ

Is Btg still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Btg do?

With this server connected, an agent can create an immediate Pix charge (cob) with QR code, retrieve an immediate Pix charge (cob) by its txid, retrieve a boleto by its BTG identifier (id or nosso_numero), and retrieve the available balance for a BTG+ checking account (conta corrente).

How do I install Btg?

Run `npx -y @codespar/mcp-btg`. The README documents 6 environment variables (BTG_CLIENT_ID, BTG_CLIENT_SECRET, BTG_CERT_PATH…) to set first. Set BTG_CLIENT_ID, BTG_CLIENT_SECRET, BTG_CERT_PATH, BTG_KEY_PATH, MCP_HTTP before connecting. BTG_ENV is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Btg run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Btg

Alternatives to Btg

Maintained security servers if Btg isn't the fit.

Pairs well with

Servers that cover what Btg doesn't - only shown when the pairing reason fits the companion.

More security MCP servers · C6 · Caixa · Itau · Santander · Sicoob

More JavaScript MCP servers · Dock · Iniciador · see all