MCP.Market

Btg MCP server

by codespar·io.github.codespar/mcp-btg·v0.1.0-alpha.3·271 stars
No reviews yet

MCP server for BTG Pactual — Pix, Boleto, Account, Investments (CDB/LCI/LCA/funds), OAuth2 + mTLS

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Established

271 stars22 downloads/wk

Reviews

Write one

Nobody has reviewed Btg yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Btg tools (12, 2 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • create_boletowrite action

    Issue a boleto via BTG Cobrança. Returns nosso_numero, linha_digitável, barcode, and PDF URL.

  • create_pix_cobwrite action

    Create an immediate Pix charge (cob) with QR code. Returns the txid, copy-paste EMV payload, and location URL. BACEN Pix v2 standard surface.

  • get_account_balance

    Retrieve the available balance for a BTG+ checking account (conta corrente). Returns available, blocked, and total balances in BRL.

  • get_account_statement

    Retrieve account statement transactions for a given period. Paginated.

  • get_boleto

    Retrieve a boleto by its BTG identifier (id or nosso_numero).

  • get_oauth_token

    Mint or return a cached OAuth2 client_credentials bearer token for the BTG Developer Portal. Exposed so agents can inspect token freshness; normal tool calls obtain tokens implicitly.

  • get_pix_cob

    Retrieve an immediate Pix charge (cob) by its txid.

  • get_portfolio_summary

    Consolidated portfolio summary across all asset classes held at BTG (fixed income, funds, equities, treasury, crypto). Returns gross value, net value, % allocation per class, and total IR/IOF estimate.

  • list_funds_available

    List funds available for distribution on BTG's platform. Returns fund CNPJ, name, manager, class (Renda Fixa | Multimercado | Ações | Cambial | Previdência | FIDC | FII), benchmark, fee schedule, minimum subscription, and liquidity (cotização / liquidação D+n).

  • list_investment_positions

    List the counterparty's investment positions held at BTG, scoped to fixed-income asset classes (CDB, LCI, LCA, LF, LFSN, debêntures, CRI, CRA). Each position includes issuer, indexer (CDI/IPCA/Prefixado), gross value, net value (after IR/IOF), and maturity.

  • redeem_from_fund

    Redeem (resgatar) from a fund. Total or partial. Settlement follows the fund's cotização/liquidação rule. Returns the request id, redemption type (total/parcial), and projected liquidation date.

  • subscribe_to_fund

    Subscribe (aplicar) to a fund on BTG's distribution platform. Settlement follows the fund's cotização/liquidação rule (typically D+0 cotização, D+1 liquidação for RF; D+30 for some FIDC). Requires a suitability profile on file.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 29 days ago15/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Btg compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 63% of 48,255 servers
Tools
12
the typical server has 7
Tools that change things
17%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
271
more than 95% of 28,688 servers
Downloads a week
22
more than 8% of 12,191 servers with a package

What its tools let an agent do: 10 read · 2 create

Install Btg in Claude Code, Cursor or VS Code

Runs npx -y @codespar/mcp-btg on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-btg -- npx -y @codespar/mcp-btg
Add to Cursor

What the publisher says

From the Btg repository's README, as published. We do not edit it. Read it on GitHub

MCP Dev LATAM 🌎 Every commerce API your AI agent needs to run a business in Latin America. Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols. MCP servers for LATAM commerce · live in the official MCP Registry · MIT License Machine-readable catalog: codespar.dev/api/servers Catalog · Quick Start · Agentic Protocols · All Servers · Contribute

The Problem

AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).

Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.

MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.

The Solution

Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.

🛒 Customer places order
  → 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
  → 📦 Agent generates shipping label (Melhor Envio / Skydropx)
  → 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
  → 📊 Agent records in ERP (Omie / Bling / Tiny)
  → 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)

Six systems. Zero human intervention. One agent.

Agentic Payment Protocols

Four servers for the emerging agentic payment stack:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Btg: common questions

Is Btg MCP server safe?
Mostly: it is graded B (82/100). Read the Btg safety report
How do I install Btg?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Btg need an API key?
Yes. The registry entry asks for BTG_CLIENT_SECRET, BTG_KEY_PATH.
Is Btg maintained?
The last commit was 67 days ago (2026-08-29). The latest release is v0.1.0-alpha.3.
How does Btg compare with other MCP servers?
safety score 82/100 (higher than 63% of 48,255 servers); tools 12 (the typical server has 7); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from codespar →