BTG Pactual

What your agent can do

BTG Pactual gives your agent 12 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →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.
• →create_pix_cob — 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_pix_cob — Retrieve an immediate Pix charge (cob) by its txid.

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("get_oauth_token", { /* ... */ });

Install

$ npm install @codespar/mcp-btg@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "btg": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-btg@alpha"
      ],
      "env": {
        "BTG_CLIENT_ID": "<your_btg_client_id>",
        "BTG_CLIENT_SECRET": "<your_btg_client_secret>",
        "BTG_CERT_PATH": "<your_btg_cert_path>",
        "BTG_KEY_PATH": "<your_btg_key_path>"
      }
    }
  }
}

After restart, your agent can call any of the 12 tools below — try get_oauth_token first.

Environment variables · 5

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 12

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions