Skip to main content
Glama
BCB Meios de Pagamento MCP

BCB Meios de Pagamento MCP

by thomaschi78

Servidor MCP - Dados Abertos de Meios de Pagamento do BCB

Servidor MCP (Model Context Protocol) para acessar os dados abertos de meios de pagamento do Banco Central do Brasil através de LLMs como Claude, ChatGPT e outros.

📋 Descrição

Este servidor MCP fornece acesso programático à API de Dados Abertos de Meios de Pagamento do Banco Central do Brasil, permitindo que assistentes de IA consultem informações sobre:

  • 💳 Transações com cartões de pagamento

  • 📊 Dados mensais e trimestrais de meios de pagamento

  • 🏪 Estabelecimentos credenciados

  • 💰 Taxas de intercâmbio e desconto

  • 🏧 Estatísticas de terminais ATM

  • 👥 Informações sobre portadores de cartão

  • 📱 Dados sobre PIX, TED, DOC, boletos e outros

Related MCP server: mcp-brasil

🚀 Instalação

# Clone o repositório
git clone https://github.com/seu-usuario/bcb-meios-pagamento-mcp.git
cd bcb-meios-pagamento-mcp

# Instale as dependências
npm install

# Compile o TypeScript
npm run build

🔧 Configuração

Este servidor oferece duas formas de uso:

Opção 1: Claude Desktop (Uso Local)

Para uso local com Claude Desktop, adicione ao arquivo de configuração (~/Library/Application Support/Claude/claude_desktop_config.json no macOS ou %APPDATA%/Claude/claude_desktop_config.json no Windows):

{
  "mcpServers": {
    "bcb-meios-pagamento": {
      "command": "node",
      "args": ["/caminho/completo/para/bcb-meios-de-pagamentos/dist/index.js"]
    }
  }
}

Opção 2: ChatGPT (Servidor Remoto)

ChatGPT requer que o servidor esteja hospedado com HTTPS. Siga estas etapas:

Passo 1: Deploy do Servidor

Escolha uma opção de deployment:

Opção A - Render (Recomendado - Free Tier)

  1. Crie uma conta em render.com

  2. Conecte seu repositório GitHub

  3. Use as configurações do arquivo render.yaml incluído

  4. Seu servidor estará disponível em https://seu-app.onrender.com

Opção B - Railway

  1. Crie uma conta em railway.app

  2. Faça deploy do repositório

  3. Use as configurações do arquivo railway.json incluído

  4. Seu servidor estará disponível em https://seu-app.railway.app

Opção C - ngrok (Desenvolvimento Local)

# Terminal 1: Inicie o servidor HTTP
npm run dev:http

# Terminal 2: Exponha via ngrok
ngrok http 3000

Consulte DEPLOYMENT.md para guia completo de deployment.

Passo 2: Configurar no ChatGPT

  1. Acesse ChatGPT com assinatura Pro, Plus, Team, Education ou Enterprise

  2. Ative o Developer Mode

  3. Adicione um novo MCP Server:

    • Nome: BCB Meios de Pagamento

    • URL SSE: https://seu-servidor.com/sse

    • Tipo: Server-Sent Events (SSE)

  4. Teste perguntando: "Quais foram os dados de PIX em dezembro de 2023?"

Opção 3: Outros LLMs

Este servidor segue o protocolo MCP padrão e é compatível com qualquer LLM que suporte:

  • Modo Local: Protocolo stdio (como Claude Desktop)

  • Modo Remoto: Protocolo SSE via HTTP/HTTPS (como ChatGPT)

🛠️ Ferramentas Disponíveis

1. consultar_meios_pagamento_mensal

Consulta dados mensais sobre meios de pagamento (PIX, TED, DOC, boletos, etc.).

Parâmetros:

  • ano_mes (obrigatório): Formato YYYYMM (ex: "202312")

  • top (opcional): Número máximo de registros

  • skip (opcional): Paginação

  • filtro (opcional): Filtro OData

Exemplo:

Consulte os dados de meios de pagamento para dezembro de 2023

2. consultar_meios_pagamento_trimestral

Consulta dados trimestrais de cartões e transferências.

Parâmetros:

  • trimestre (obrigatório): Formato YYYYQ (ex: "20234")

  • top (opcional): Número máximo de registros

  • skip (opcional): Paginação

  • filtro (opcional): Filtro OData

Exemplo:

Mostre os dados trimestrais do 4º trimestre de 2023

3. consultar_transacoes_cartoes

Consulta estoque e transações de cartões.

Parâmetros:

  • trimestre (obrigatório): Formato YYYYQ

  • top (opcional): Número máximo de registros

  • ordenar_por (opcional): Campo para ordenação

  • filtro (opcional): Filtro OData

4. consultar_estabelecimentos_credenciados

Consulta quantidade de estabelecimentos credenciados.

Parâmetros:

  • trimestre (obrigatório): Formato YYYYQ

  • top (opcional): Número máximo de registros

  • ordenar_por (opcional): Campo para ordenação

  • filtro (opcional): Filtro OData

5. consultar_taxas_intercambio

Consulta taxas de intercâmbio do mercado.

Parâmetros:

  • trimestre (obrigatório): Formato YYYYQ

  • top (opcional): Número máximo de registros

  • filtro (opcional): Filtro OData

6. consultar_taxas_desconto

Consulta taxas de desconto cobradas de estabelecimentos.

Parâmetros:

  • trimestre (obrigatório): Formato YYYYQ

  • top (opcional): Número máximo de registros

  • filtro (opcional): Filtro OData

7. consultar_terminais_atm

Consulta estatísticas sobre terminais ATM.

Parâmetros:

  • trimestre (obrigatório): Formato YYYYQ

  • top (opcional): Número máximo de registros

  • filtro (opcional): Filtro OData

8. consultar_portadores_cartao

Consulta informações sobre portadores de cartão.

Parâmetros:

  • trimestre (obrigatório): Formato YYYYQ

  • top (opcional): Número máximo de registros

  • filtro (opcional): Filtro OData

📖 Exemplos de Uso

Após configurar o servidor, você pode fazer perguntas naturais ao seu assistente de IA:

Quais foram os dados de PIX em dezembro de 2023?

Mostre as transações com cartões no último trimestre de 2023

Quantos estabelecimentos estavam credenciados no 3º trimestre de 2023?

Quais são as taxas de intercâmbio atuais?

🔍 Filtros OData

Você pode usar filtros OData para refinar suas consultas:

Modalidade eq 'PIX'
Trimestre eq '20234'
Valor gt 1000000

Operadores suportados:

  • eq: igual

  • ne: diferente

  • gt: maior que

  • ge: maior ou igual

  • lt: menor que

  • le: menor ou igual

  • and: e lógico

  • or: ou lógico

🔗 API do Banco Central

Este servidor utiliza a API oficial de Dados Abertos do Banco Central do Brasil: https://olinda.bcb.gov.br/olinda/servico/MPV_DadosAbertos/versao/v1/swagger-ui3

📄 Licença

MIT

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues e pull requests.

📧 Contato

Para dúvidas ou sugestões, abra uma issue no GitHub.

📚 Documentação Adicional

🔄 Atualizações

  • v1.0.0 (2024): Versão inicial com 8 ferramentas principais

  • v1.1.0 (2025): Adicionado suporte para ChatGPT via HTTP/SSE

Available Tools

8 tools
consultar_estabelecimentos_credenciadosB

Consulta quantidade de estabelecimentos credenciados para aceitar meios de pagamento eletrônico por trimestre.

Inputs: trimestre (required), top, filtro, ordenar_por.

consultar_meios_pagamento_mensalA

Consulta dados mensais sobre meios de pagamento, incluindo operações com boletos bancários, PIX, TED, DOC e outros. Use o formato YYYYMM para o parâmetro ano_mes (exemplo: '202312' para dezembro de 2023).

Inputs: ano_mes (required), top, skip, filtro.

consultar_meios_pagamento_trimestralB

Consulta dados trimestrais sobre operações com cartões de pagamento e transferências de crédito. Use o formato YYYYQ para o parâmetro trimestre (exemplo: '20234' para o 4º trimestre de 2023).

Inputs: trimestre (required), top, skip, filtro.

consultar_portadores_cartaoB

Consulta informações sobre portadores de cartões de pagamento por trimestre.

Inputs: trimestre (required), top, filtro.

consultar_taxas_descontoC

Consulta taxas de desconto cobradas de estabelecimentos comerciais por operações com meios de pagamento.

Inputs: trimestre (required), top, filtro.

consultar_taxas_intercambioB

Consulta taxas de intercâmbio praticadas no mercado de meios de pagamento por trimestre.

Inputs: trimestre (required), top, filtro.

consultar_terminais_atmA

Consulta estatísticas sobre terminais de autoatendimento (ATM/caixas eletrônicos) por trimestre.

Inputs: trimestre (required), top, filtro.

consultar_transacoes_cartoesC

Consulta estoque e transações de cartões de pagamento por trimestre. Retorna dados sobre quantidade e valor das transações realizadas com cartões.

Inputs: trimestre (required), top, filtro, ordenar_por.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools target a clearly distinct dataset, such as interchange fees, discount fees, ATMs, cardholders, and merchants. Some overlap exists between monthly/quarterly payment method statistics and card transaction statistics, but the descriptions help clarify the different periods and instruments.

    Naming Consistency5/5

    All tool names follow the same predictable pattern: consultar_ + a descriptive noun phrase, consistently using snake_case and Portuguese terminology. Temporal qualifiers like mensal and trimestral are used consistently where relevant.

    Tool Count5/5

    Eight tools is a well-scoped count for a specialized payment statistics server. Each tool represents a meaningful data family without unnecessary duplication or excessive surface area.

    Completeness4/5

    The set covers the main payment-system statistics areas: fees, payment instruments, cards, cardholders, ATMs, and merchants. Minor gaps exist for related data like specific payment arrangements or participants, but the core read-only query workflows are well supported.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Connects AI agents to 28 Brazilian public APIs, providing over 200 tools to access data on economy, legislation, transparency, and the judiciary. It enables complex queries and cross-referencing of government datasets like IBGE, the Central Bank, and the National Congress through natural language.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects Brazilian banks (Itaú, Bradesco, Nubank, etc.) to AI agents, enabling natural language queries about expenses, statements, investments, and credit cards via regulated Open Finance.
      27
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides point-in-time Brazilian market data and official statistics, enabling accurate backtesting and AI agent access to vintage, unrevised data, as well as Brazilian financial primitives like PIX code generation and business day calculations.
      MIT