Pular para o conteúdo
Pagamentos

Pix BCB (CodeSpar)

Servidor MCP (pacote @codespar/mcp-pix-bcb) para a API Pix do Banco Central: cobranças, transferências, QR codes, consulta de chave DICT e devoluções. 18 ferramentas.

Ainda não testado

Link conferido em 03/11/2026, sem instalar.

Atenção: O pacote cria e altera cobranças Pix, lista Pix recebidos, pede devoluções e registra chaves Pix, com as suas credenciais de um participante do Pix. A página do catálogo também descreve transferências instantâneas. As operações, inclusive transferências, são reais. Teste no ambiente de homologação do seu banco ou PSP.

Mantido por CodeSpar, não pelo Estuda com IA. Nunca cole chave de API, token ou senha no chat.

O que faz

A página do catálogo CodeSpar descreve o pacote @codespar/mcp-pix-bcb (versão 0.2.2 na verificação), com 18 ferramentas para a API do Pix. A página descreve transferências instantâneas, QR codes, consulta de chave DICT e devoluções, e a lista de ferramentas inclui criar e alterar cobranças (imediatas e com vencimento), consultar Pix recebidos, pedir devoluções e registrar chave Pix. Roda localmente com as suas credenciais, autenticação OAuth2, licença MIT.

A própria página aponta uma limitação: o manifesto do pacote não declara 3 das 4 variáveis de ambiente que o código lê. Na prática, a documentação do pacote não avisa todas as configurações de que ele precisa; use a lista da página do catálogo. É um pacote da CodeSpar, não do Banco Central.

Para quem

Pessoas desenvolvedoras com acesso à API Pix por meio de um participante autorizado.

Como usar

Segundo a página do catálogo CodeSpar, o servidor roda no seu computador com as suas credenciais. No Claude Code, o comando é este (os valores das 4 variáveis vêm do seu participante do Pix e ficam na configuração, nunca no chat):

claude mcp add pix-bcb -e PIX_BASE_URL=… -e PIX_CERT_PATH=… -e PIX_CLIENT_ID=… -e PIX_CLIENT_SECRET=… -- npx -y @codespar/mcp-pix-bcb@0.2.2

Depois, rode /mcp no Claude Code para confirmar a conexão. A página também tem configurações para Cursor, Claude Desktop e VS Code.

Pedido de exemplo (da página): criar uma cobrança Pix imediata (ferramenta create_cob). Faça isso só em homologação.

Descrição e passo a passo baseados no que a página oficial ou o repositório informava na data de verificação. Não instalamos este MCP ainda. Confira a documentação antes de usar e comece em ambiente de testes.

Veja também