get_regional_rankingRisco 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
| Nome | Tipo | Obrigatório | Limites | Descrição |
|---|---|---|---|---|
dataset | string | não | npl_pf (padrão), npl_pj ou npl_total | Inadimplência de pessoas físicas, de empresas ou total. |
order | string | não | desc (padrão) ou asc | Ordem do ranking. |
limit | integer | não | 1 a 27; padrão 5 | Quantos 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.