Pix Bcb MCP Server

The Pix BCB API uses OAuth2 client credentials with mTLS. Each PSP (bank) provides their own base URL and certificate requirements. Its 18 documented tools cover pix, key, cob, cobv.

People connecting API integration tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Pix Bcb

before you install - you'll need

Set PIX_BASE_URL, PIX_CLIENT_ID, PIX_CLIENT_SECRET, PIX_CERT_PATH before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-pix-bcb

Claude Desktop / Cursor / VS Code - add to config

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

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-pix-bcb - published under the repo owner's npm scope (@codespar)

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

03 · What Pix Bcb 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 (cobranca imediata), get immediate charge details by txid, list immediate charges with date range and filter, and create a due-date Pix charge (cobranca com vencimento).

Capability map

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

Pix

5 tools - e.g. Get a received Pix payment by e2eid (endToEndId); List received Pix payments within a date range; Register a Pix key in DICT (requires PSP support)

get_pix · list_pix_received · create_pix_key · get_pix_key · list_pix_keys

Cob

3 tools - e.g. Create an immediate Pix charge (cobranca imediata); Get immediate charge details by txid; Revise an existing immediate charge (PATCH /cob/{txid}).

create_cob · get_cob · update_cob

Cobv

3 tools - e.g. Create a due-date Pix charge (cobranca com vencimento); List due-date charges (cobv) within a date range; Revise an existing due-date charge (PATCH /cobv/{txid})

create_cobv · list_cobv · update_cobv

Devolucao

2 tools - e.g. Request a refund (devolução) for a received Pix (PUT /pix/{e2eid}/devolucao/{id}); Get refund details by e2eid + refund id (GET /pix/{e2eid}/devolucao/{id})

create_devolucao · get_devolucao

Webhook

2 tools - e.g. Configure a webhook URL for a given Pix key (PUT /webhook/{chave}).; Remove the webhook configured for a Pix key (DELETE /webhook/{chave})

set_webhook · delete_webhook

read & search

1 tool - e.g. List immediate charges with date range and filters

list_cobs

Request

1 tool - e.g. Request portability of a Pix key from another PSP into this PSP (DICT portability flow)

request_key_portability

Resolve

1 tool - e.g. Resolve a pending DICT key claim (confirm or cancel) - POST /dict/keys/claims/{id}/resolve

resolve_key_claim

04 · Who maintains Pix Bcb

mcp-pix-bcb 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: API integration - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-pix-bcb (active, first published 2026-04-12 · 3 versions)
packages: npm:@codespar/mcp-pix-bcb

06 · Pix Bcb FAQ

Is Pix Bcb still maintained?

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

What can Pix Bcb do?

How do I install Pix Bcb?

Run `npx -y @codespar/mcp-pix-bcb`. The README documents 4 environment variables (PIX_BASE_URL, PIX_CLIENT_ID, PIX_CLIENT_SECRET…) to set first. Set PIX_BASE_URL, PIX_CLIENT_ID, PIX_CLIENT_SECRET, PIX_CERT_PATH before connecting. You can also paste the ready-made client config above.

Does Pix Bcb 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 Pix Bcb

Alternatives to Pix Bcb

Maintained API integration servers if Pix Bcb isn't the fit.

More API integration MCP servers · Portkey Admin MCP · Dataverse · Omni Nli · ComparEdge LLM Cost · Compar Edge

More JavaScript MCP servers · Rapyd · Rede · Rinne · Safrapay · Stone · see all