Pular para o conteúdo
Análise · get_regional_ranking

Risco de crédito por estado

O risco de crédito está piorando nos estados? Conta quantos estados tiveram alta ou queda da inadimplência em 12 meses, mostra quem lidera e a distância de cada um para a mediana nacional.

Parâmetros

NomeTipoObrigatórioLimitesDescrição
datasetstringnãonpl_pf (padrão), npl_pj ou npl_totalInadimplência de pessoas físicas, de empresas ou total.
orderstringnãodesc (padrão) ou ascOrdem do ranking.
limitintegernão1 a 27; padrão 5Quantos estados entram no ranking de apoio.
Schema JSON (tools/list)
{
  "type": "object",
  "properties": {
    "dataset": {
      "description": "npl_pf (individuals, default), npl_pj (companies) or npl_total.",
      "type": "string",
      "default": "npl_pf"
    },
    "order": {
      "description": "desc (highest first, default) or asc.",
      "type": "string",
      "default": "desc"
    },
    "limit": {
      "description": "Number of states in the supporting ranking, 1-27 (default 5).",
      "type": "integer",
      "default": 5
    }
  }
}

Exemplo de requisição

JSON-RPC 2.0 via POST https://mcp.financialcloud.com.br (Streamable HTTP, sem autenticação).

{
  "jsonrpc": "2.0",
  "id": 6,
  "method": "tools/call",
  "params": {
    "name": "get_regional_ranking",
    "arguments": {
      "dataset": "npl_pf",
      "order": "desc",
      "limit": 5
    }
  }
}

Exemplo de resposta

Exemplo de resposta real (2026-10-14). O campo analysis vem primeiro; data traz só os números de apoio.

{
  "analysis": "Risco de crédito em alta (Inadimplência pessoas físicas): 27 de 27 estados pioraram em 12 meses e 0 melhoraram. TO lidera inadimplência pessoas físicas, com 11,06% (+4,31 p.p. vs. a mediana nacional de 6,75%).",
  "signal": "risco_credito:em alta",
  "data": {
    "dataset": "npl_pf",
    "label": "Inadimplência pessoas físicas",
    "unit": "%",
    "date": "2026-08-01",
    "nationalMedian": 6.75,
    "statesRising": 27,
    "statesFalling": 0,
    "risk": "em alta",
    "ranking": [
      {
        "rank": 1,
        "uf": "TO",
        "value": 11.06,
        "gapToMedianPp": 4.31,
        "change12m": 3.71
      },
      {
        "rank": 2,
        "uf": "MA",
        "value": 10.31,
        "gapToMedianPp": 3.56,
        "change12m": 3.9
      },
      {
        "rank": 3,
        "uf": "MS",
        "value": 9.23,
        "gapToMedianPp": 2.48,
        "change12m": 3
      },
      {
        "rank": 4,
        "uf": "GO",
        "value": 8.24,
        "gapToMedianPp": 1.49,
        "change12m": 2.31
      },
      {
        "rank": 5,
        "uf": "PA",
        "value": 7.56,
        "gapToMedianPp": 0.81,
        "change12m": 2.11
      }
    ]
  },
  "source": "BCB SGS",
  "asOf": "2026-08-01",
  "attribution": "Fonte: Banco Central do Brasil (dados abertos, licença ODbL)",
  "dashboard": "https://www.financialcloud.com.br",
  "citation": "Fonte: Banco Central do Brasil (dados abertos, licença ODbL), BCB SGS, dados até 2026-08-01. Análise derivada: Financial Cloud (https://www.financialcloud.com.br).",
  "sourceUrls": []
}

Séries usadas

  • 81 séries regionais do SGS (Crédito regional (inadimplência)), códigos 15861 a 15951: ver no catálogo

Cobertura: posição mais recente (dados até 2026-08-01). Detalhes de cada série (frequência, período, linhas) no catálogo de dados.

Metodologia

  • Inadimplência = percentual da carteira de crédito com atraso acima de 90 dias, por UF, nas séries regionais do SGS.
  • Mediana nacional: mediana dos valores mais recentes dos 27 estados.
  • Risco “em alta” quando mais estados pioraram do que melhoraram em 12 meses, “em queda” no caso contrário e “estável” no empate.
  • Cada estado do ranking traz o valor, a variação em 12 meses e a distância (p.p.) para a mediana nacional.

Atualização

Diária, às 22:17 UTC (19:17 em Brasília). O servidor relê as análises a cada 15 minutos.

Pergunte ao seu agente

Prompt pronto, que já diz ao agente qual ferramenta usar:

Use a ferramenta get_regional_ranking do MCP Financial Cloud (dataset: npl_pf, limit: 5) e me diga se a inadimplência das pessoas físicas está piorando nos estados e quem lidera. Cite a fonte.

Atribuição

Fonte: Banco Central do Brasil (dados abertos, licença ODbL) — licença ODbL. Análise derivada: Financial Cloud. Toda resposta traz esse texto no campo attribution e uma citação pronta em citation.