Skills do Balanços.AI

Skills para agentes de IA (Claude, ChatGPT, Codex, Cursor e outros) usarem bem o MCP do Balanços.AI: rotinas prontas para investigar uma empresa brasileira, comparar concorrentes, fazer due diligence financeira, originar operações de M&A e ler publicações legais, sempre a partir de balanços e DREs publicados.

O MCP entrega o dado. As skills ensinam o agente o que fazer com ele: em que ordem chamar as ferramentas, como calcular indicadores com os campos que voltam, que ressalvas declarar e o que responder quando o dado não existe.

Skills

Skill	Use quando
balancos-ai	Base: como o MCP funciona, ferramentas, limites, vocabulário. As demais assumem esta.
companhia-aberta	Empresa é S.A. aberta: consolidado, conta a conta, DFC, EBITDA, dívida líquida, parecer, reapresentação, trimestre e últimos doze meses, ranking de abertas.
instituicao-financeira	Empresa é banco, cooperativa ou financeira: carteira, captações, Basileia, trimestre, conglomerado, ranking do IF.data.
indicadores-financeiros	Precisar calcular liquidez, endividamento, margens, ROE, ROA, CAGR a partir do BP e da DRE.
investigar-empresa	"Me conta sobre a empresa X", "o que sabemos da X".
comparar-empresas	"X versus Y", "compara essas cinco", "como a X fica frente aos pares".
due-diligence-financeira	Homologar fornecedor ou cliente, avaliar alvo de aquisição ou investimento.
originacao-ma	Mapear alvos de aquisição num setor ou possíveis compradores para uma empresa.
ler-publicacao	Ler uma ata, notas explicativas, parecer de auditoria ou relatório da administração.

Três fontes num MCP só

Fonte	Tools	Quem	O que traz
Publicações	buscar_empresas, analisar_empresa, texto_documento, ranking_empresas...	qualquer empresa com publicação legal	BP de 8 linhas, DRE de 6, individual, texto integral das publicações
CVM	cvm_*	companhias abertas: DFP (2010 em diante) e ITR (2011 em diante)	consolidado e individual, conta a conta com DFC e DVA, série trimestral com últimos doze meses, parecer do auditor, reapresentações
BCB	bcb_*	instituições financeiras do IF.data (2000 em diante)	série trimestral, carteira, captações, Basileia, conglomerados

A skill balancos-ai ensina a rotear pelo CNPJ; companhia-aberta e instituicao-financeira ensinam cada fonte; as skills de tarefa usam a fonte certa.

Instalar

Claude Code, Codex, Cursor e outros agentes de terminal

Instala todas as skills nos agentes detectados na máquina:

npx skills add natangorin/skills-balancos-ai

No Claude Code também dá para instalar como plugin, que já conecta o MCP (login OAuth na primeira chamada):

/plugin marketplace add natangorin/skills-balancos-ai
/plugin install balancos-ai@balancos-ai

Sem o plugin, conecte o MCP diretamente:

claude mcp add --transport http balancos-ai https://mcp.balancos.ai/mcp

Para usar uma chave de API em vez do login (criada em Minha conta):

claude mcp add --transport http balancos-ai https://mcp.balancos.ai/mcp \
  --header "Authorization: Bearer bal_live_..."

Claude.ai e Claude Desktop

1. Conecte o MCP em Configurações › Conectores › Adicionar conector personalizado, com a URL https://mcp.balancos.ai/mcp, e faça o login.
2. Gere os arquivos das skills com make zips (ou baixe da página de releases) e suba cada dist/<skill>.zip em Configurações › Capacidades › Skills.

Cada skill funciona sozinha. Suba só as que fizer sentido para o seu uso; a balancos-ai é a única que vale a pena ter sempre.

Outros clientes MCP

Qualquer cliente que aceite servidores MCP remotos por HTTP conecta em https://mcp.balancos.ai/mcp. O conteúdo das skills é Markdown: cole a SKILL.md que precisar nas instruções do seu agente.

O que sai da sua máquina

As skills fazem o agente chamar o MCP do Balanços.AI, um serviço externo em mcp.balancos.ai. Cada chamada leva os parâmetros da tool (nome de empresa, CNPJ, métrica, filtro) com a sua autenticação, e o uso fica registrado na sua conta conforme a política de privacidade e os termos. O conteúdo da conversa não vai para o serviço; só o que o agente coloca nos parâmetros. As skills não mandam o agente chamar nenhum outro endereço.

O que as skills não fazem

• Não substituem o MCP: sem ele conectado, o agente não tem dado.
• Não inventam o que a base não tem. Para companhia aberta, fluxo de caixa, EBITDA, dívida líquida e cobertura de juros vêm do conta a conta da CVM, com o código da conta; para as demais, as skills ensinam a buscar isso no texto das publicações e a declarar quando não encontrou.
• Não emitem nota de crédito, rating ou recomendação de investimento. Entregam evidência organizada e perguntas a fazer.

Atualizações

Nenhum caminho atualiza sozinho por padrão. Para pegar a versão mais nova das skills:

This is the beginning of the README. Read the rest at the original. Read the full README ↗