PagôMetro MCP Server

MCP Server para consulta de risco fiscal de órgãos públicos brasileiros.

Conecta qualquer app compatível com MCP (Claude, Cursor, etc.) diretamente ao PagôMetro — sistema com dados de 5.500+ municípios e estados, calculados com base no SICONFI / Secretaria do Tesouro Nacional.

Ferramentas disponíveis

buscar_orgao

Busca órgãos por nome, UF ou código IBGE.

| Parâmetro | Tipo | Obrigatório | Descrição | |------------|--------|-------------|-----------| | q | string | ✅ | Nome do município, sigla UF ou código IBGE | | uf | string | ❌ | Filtrar por estado (ex: SP, RJ) | | esfera | enum | ❌ | MUNICIPAL, ESTADUAL ou FEDERAL | | scoreMin | number | ❌ | Score mínimo (0–100) | | scoreMax | number | ❌ | Score máximo (0–100) | | limit | number | ❌ | Resultados por consulta (padrão: 10, máx: 50) |

Retorno: Lista com id, nome, UF, esfera, score atual e perfil de risco.

consultar_score

Score completo e todos os indicadores fiscais de um órgão.

| Parâmetro | Tipo | Obrigatório | Descrição | |------------|--------|-------------|-----------| | orgao_id | string | ✅ | ID único do órgão (obtido via buscar_orgao) |

Retorno: Score total (0–100), scores dos 4 pilares, indicadores brutos (DCL/RCL, margem corrente, pessoal/RCL, CAUC), penalidades e histórico.

analisar_fornecedor

Análise fiscal completa em linguagem natural — escrita para quem vai vender para o órgão.

| Parâmetro | Tipo | Obrigatório | Descrição | |------------|--------|-------------|-----------| | orgao_id | string | ✅ | ID único do órgão |

Retorno: Texto completo com diagnóstico dos pilares, alertas e recomendações práticas (se vale a pena vender, como precificar, o que monitorar).

ranking

Ranking de órgãos ordenado por score fiscal.

| Parâmetro | Tipo | Obrigatório | Descrição | |-----------|--------|-------------|-----------| | uf | string | ❌ | Filtrar por estado | | esfera | enum | ❌ | MUNICIPAL, ESTADUAL ou FEDERAL | | faixa | enum | ❌ | muito-baixo, baixo, moderado, alto, critico | | order | enum | ❌ | desc = melhores primeiro (padrão), asc = piores | | limit | number | ❌ | Resultados (padrão: 20, máx: 100) |

Retorno: Lista com posição, nome, UF, score, perfil de risco e tendência (▲/▼).

dashboard_nacional

Panorama geral do Brasil: score médio, total analisado, distribuição por faixa.

Sem parâmetros.

Retorno: Score médio nacional, total de órgãos, distribuição percentual por faixa de risco, top 5 melhores e piores scores.

Instalação

Opção A — npx (sem instalar)

npx pagometro-mcp

Opção B — instalação global

npm install -g pagometro-mcp
pagometro-mcp

Opção C — clonar e rodar localmente

cd pagometro/mcp
npm install
npm run build
node dist/index.js

Configuração no Claude Code

Adicione ao seu ~/.claude.json (ou claude_desktop_config.json):

{
  "mcpServers": {
    "pagometro": {
      "command": "npx",
      "args": ["-y", "pagometro-mcp"],
      "env": {
        "PAGOMETRO_URL": "http://187.77.250.253"
      }
    }
  }
}

Ou, se instalado globalmente:

{
  "mcpServers": {
    "pagometro": {
      "command": "pagometro-mcp",
      "env": {
        "PAGOMETRO_URL": "http://187.77.250.253"
      }
    }
  }
}

Variáveis de ambiente

| Variável | Padrão | Descrição | |-----------------|---------------------------|-----------| | PAGOMETRO_URL | http://187.77.250.253 | URL base do servidor PagôMetro |

Exemplos de uso

Verificar risco antes de fechar um contrato

"Qual o risco de vender para a Prefeitura de Curitiba?"

O Claude vai:

1. Chamar buscar_orgao com q: "Curitiba" e uf: "PR"
2. Chamar analisar_fornecedor com o ID retornado
3. Apresentar a análise completa

Encontrar municípios seguros em SP

"Liste os 10 municípios de SP com menor risco fiscal"

→ ranking com uf: "SP", faixa: "muito-baixo", limit: 10

Panorama nacional

"Como está a saúde fiscal dos municípios brasileiros?"

→ dashboard_nacional sem parâmetros

Comparar dois municípios

"Compare o risco fiscal de Florianópolis e Porto Alegre"

→ Duas chamadas a buscar_orgao + duas a consultar_score

Estrutura da Pontuação

| Score | Perfil | Emoji | |---------|--------------------|-------| | 81–100 | Risco Muito Baixo | 🔵 | | 61–80 | Risco Baixo | 🟢 | | 41–60 | Risco Moderado | 🟡 | | 21–40 | Risco Alto | 🟠 | | 0–20 | Risco Crítico | 🔴 |

Os 4 pilares (25% cada)

| Pilar | O que mede | |----------------|-----------| | 💰 Caixa | Dinheiro disponível vs. obrigações de curto prazo | | 📋 Fornecedores | Dívidas pendentes com fornecedores (Restos a Pagar) | | 📉 Endividamento | Dívida Consolidada Líquida / Receita Corrente Líquida | | 📊 Margem | Despesas correntes / Receita — sobra para imprevistos |

Penalidades extras: Gastos com pessoal acima da LRF (−5 a −25 pts) e pendências no CAUC (−3 pts por pendência, limitado a −45 pts).

Fonte dos dados

• SICONFI — Sistema de Informações Contábeis e Fiscais do Setor Público Brasileiro
• Tesouro Nacional — Ministério da Fazenda
• Atualizado semestralmente (RREO bimestral + RGF semestral)