sienge
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SIENGE_API_URL | Yes | The URL of the Sienge API, e.g., https://api.sienge.com.br | |
| SIENGE_API_USER | Yes | The API user name for Sienge | |
| SIENGE_API_PASSWORD | Yes | The password for the API user |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| sienge_statusA | Confere se o Sienge está configurado e acessível: lê o .env, faz uma chamada real (lista de empresas) e resume os padrões em uso (empresa, documento, indexador, plano) e o que ainda falta. Primeira coisa a chamar numa sessão. |
| listar_empresasA | Lista as empresas (devedoras) cadastradas no Sienge: código, nome, nome fantasia e CNPJ. Use para escolher a empresa padrão dos lançamentos. |
| listar_centros_custoA | Lista os centros de custo do Sienge (obras, departamentos, administrativo...), com filtro por texto e por empresa. Vem de um cache de 24h para poupar a cota da API; passe atualizar:true para buscar de novo. |
| listar_planos_financeirosA | Lista o plano financeiro (categorias de despesa/receita) do Sienge. Por padrão mostra só contas ativas e de resultado (as que recebem lançamento). Cache de 24h; atualizar:true força a busca. |
| listar_departamentosC | Lista os departamentos do Sienge (apropriação opcional do título). Cache de 24h. |
| listar_indexadoresB | Lista os indexadores do Sienge (o título precisa de um; normalmente "Real"). Use no setup para definir SIENGE_INDEXADOR_PADRAO. |
| verificar_documentoA | Confere quais códigos de tipo de documento existem no Sienge (ex.: NF, NFE, CF, REC). A API não tem listagem, só consulta por código: cada código testado gasta 1 requisição. Use no setup para definir SIENGE_DOCUMENTO_PADRAO. |
| buscar_credorA | Busca o fornecedor (credor) no Sienge por CNPJ, CPF ou nome. Valida o dígito verificador antes: CNPJ inválido quase sempre é erro de leitura da foto — nesse caso confira a imagem ou peça o número ao usuário. |
| criar_credorA | Cadastra um fornecedor (credor) no Sienge. Exige confirmado:true — só chame depois que o usuário aprovou no chat. Se já existir credor com o mesmo documento, devolve o existente sem duplicar. |
| sugerir_apropriacaoA | Sugere centro de custo e plano financeiro para a despesa, usando o histórico confirmado do fornecedor (config/aprendizado.json) e as regras do usuário (config/regras.json). Não gasta requisição. Sem sugestão = pergunte ao usuário. |
| aprender_apropriacaoA | Grava em config/aprendizado.json a apropriação que o usuário confirmou para este fornecedor, para sugerir automaticamente da próxima vez. Chame depois de cada título lançado com sucesso. |
| buscar_titulosA | Busca títulos do contas a pagar por período de emissão (obrigatório) e filtros opcionais (credor, número do documento, empresa, centro de custo). Use para conferir duplicidade ou achar um título lançado. |
| criar_tituloA | Lança um título no contas a pagar do Sienge (POST /bills). Exige confirmado:true — só chame depois de mostrar o resumo e receber o OK do usuário. Antes de criar, procura duplicidade (mesmo credor + número do documento em ±60 dias) e recusa se achar, salvo ignorar_duplicidade:true. Datas em DD/MM/AAAA ou AAAA-MM-DD; valores como na nota (1.234,56). |
| anexar_arquivo_tituloA | Anexa um arquivo (foto da nota, PDF, XML) a um título já lançado. Limite do Sienge: 70 MB. |
| consultar_tituloA | Lê um título do Sienge pelo número (com parcelas e, se pedido, anexos). Use para provar que o lançamento entrou como esperado. |
| arquivar_notaA | Move a foto/arquivo da nota já lançada para notas/lancadas/AAAA-MM/-. dentro do repositório, para não lançar duas vezes. Nada sai da máquina. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Each tool targets a distinct resource or action: reference-data listers, creditors, title search/creation/query, attachments, and learning helpers. The only potentially similar pair is buscar_titulos vs consultar_titulo, but one is a filtered search and the other is a direct read by number, so the boundary is clear.
Most tools follow a consistent verb_noun pattern in Portuguese: listar_*, buscar_*, criar_*, consultar_*, anexar_*. The single outlier is sienge_status, which is noun-based and breaks the pattern, but it is still easily recognizable and does not create confusion.
At 16 tools, the server is just slightly above the ideal range, but every tool appears to cover a genuine step in the Sienge setup and bill-launching workflow. The count is reasonable for an ERP integration that needs reference data, creditor management, title creation, and file handling.
The tool surface covers the full workflow: setup/status, reference data, creditor search/create, title search/create/query, attachment, and post-launch file archiving. Minor gaps exist, such as no update or cancellation operations for titles and no pagination/listing of all titles, but these are not essential to the apparent core purpose.