Documentação da API
Todos os endpoints usam autenticacao por header X-API-Key. A URL base e https://api.hub.sei.tec.br.
Autenticacao
curl https://api.hub.sei.tec.br/v1/me \
-H "X-API-Key: sk_live_sua_chave_aqui"Cada resposta traz os headers X-Quota-Remaining e X-Quota-Used com o consumo do período.
Consumo e saldo de unidades
Consulte o saldo do período direto da sua aplicação com GET /v1/usage. É uma rota de leitura — não consome cota — ideal para exibir saldo ou alertar o usuário antes de esgotar o plano.
curl https://api.hub.sei.tec.br/v1/usage \
-H "X-API-Key: sk_live_sua_chave_aqui"Principais campos da resposta:
| includedUnits | Cota inclusa no plano (null = ilimitado) |
| extraUnits | Unidades de pacotes adicionais do período |
| totalUnits | Cota efetiva (inclusa + pacotes) |
| usedUnits | Unidades já consumidas no período |
| remainingUnits | Saldo restante (null = ilimitado) |
| percentUsed | Percentual da cota já utilizado (0–100) |
| overageUnits | Unidades acima da cota (quando há excedente) |
| period.daysRemaining | Dias até a renovação do período |
Para apenas identificar a chave e o plano, use GET /v1/me (também sem gastar cota).
Conectar sua IA (MCP)
Conecte seu assistente de IA
O SEI API Hub é um servidor MCP (Model Context Protocol) — o padrão que o Claude, o ChatGPT e outros assistentes usam para acessar ferramentas externas. Conectado, o assistente consulta e executa cálculos de verdade nos nossos motores, respeitando a cota do seu plano.
Endereço do servidor
https://api.hub.sei.tec.br/mcpAutenticação
Duas formas — use a que o seu cliente suportar.
Chave de API
Envie o header Authorization: Bearer sk_live_… com uma chave da sua conta. Gere a chave no painel, em Chaves de API.
Entrar com SEI (OAuth)
Para conectores que preferem login. Ao adicionar o servidor, abre a tela de autorização do SEI — faça login (e 2FA, se tiver) e autorize. Sem colar chave.
Ferramentas disponíveis
| Ferramenta | O que faz | Consome cota? |
|---|---|---|
sei_listar_indices | Índices econômicos aceitos (código + nome). | não |
sei_listar_endpoints | Catálogo de cálculos: slug, categoria, campos e exemplo. | não |
sei_consultar_saldo | Saldo e consumo de unidades do período. | não |
sei_consultar_indice | Valor de um índice econômico numa data (código + data). | sim |
sei_calc_<cálculo> | Uma ferramenta por cálculo (ex.: sei_calc_juros-simples, sei_calc_correcao-monetaria), já com os parâmetros certos e validados. Aparecem só os cálculos do seu plano. | sim |
sei_calcular | Cálculo genérico por slug (alternativa, caso a ferramenta específica não apareça). | sim |
Peça ao assistente, por exemplo: "corrija R$ 1.000 de 01/01/2019 a 02/01/2021 pelo índice 48" — ele escolhe a ferramenta do cálculo, já sabe os parâmetros (formato de data, índice, tipo de juros) e executa. Se algum dado faltar ou estiver fora do aceito, a ferramenta avisa o campo e o assistente corrige sozinho.
O servidor também oferece recursos de leitura (o catálogo de cálculos e a tabela de índices) e modelos de prompt prontos (ex.: "corrigir um valor por um índice entre datas") — alguns assistentes os exibem como atalhos.
Como adicionar
Claude
- Configurações → Conectores → Adicionar conector personalizado.
- Cole a URL
https://api.hub.sei.tec.br/mcp. - Autorize com sua conta (OAuth) e ative o conector na conversa.
ChatGPT
- Configurações → Conectores (ou modo desenvolvedor).
- Adicione o servidor MCP com a mesma URL.
- Faça login pelo "Entrar com SEI" e autorize.
Sem OAuth, dá para usar a chave de API direto no header do conector (ou via mcp-remote no Claude Desktop).
Carregando endpoints...
Pronto para integrar?
Criar conta e gerar chave