equatorial-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HEADLESS | No | Define se o navegador roda em modo headless (true/false). | true |
| EQUATORIAL_UC | Yes | Unidade Consumidora (UC) da conta. | |
| EQUATORIAL_UF | No | Unidade Federativa (UF). Somente GO é suportado no v0.1.0. | GO |
| EQUATORIAL_CPF | Yes | CPF do titular da conta (11 dígitos com dígitos verificadores válidos). | |
| EQUATORIAL_NASCIMENTO | Yes | Data de nascimento no formato DD/MM/AAAA. |
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": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listar_ucsA | Lista as Unidades Consumidoras disponíveis na conta Equatorial configurada. Não baixa faturas. |
| listar_faturasA | Lista faturas disponíveis para uma UC autorizada e devolve fatura_id opaca para download inequívoco. |
| baixar_faturaA | Baixa uma segunda via em PDF e extrai dados locais. Use preferencialmente a fatura_id retornada por listar_faturas. |
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 3 tools
Each tool has a clearly distinct purpose: listing consumer units, listing invoices for a specific unit, and downloading an invoice. There is no overlap, and the descriptions reinforce the boundaries (e.g., listar_ucs explicitly says it does not download invoices). An agent can easily select the correct tool for each step.
All tool names follow a consistent verb_noun pattern in Portuguese: listar_ucs, listar_faturas, baixar_fatura. The verbs are action-oriented (list, download) and the nouns are the resources (UCs, invoices). The pattern is uniform and predictable.
With exactly 3 tools, the server is well-scoped for its purpose of retrieving energy invoices. Each tool serves a necessary step in the workflow, and there is no redundancy or unnecessary bloat. This is an ideal size for a focused utility integration.
The tool set covers the complete lifecycle for the stated purpose: listing consumer units to identify the target, listing invoices to select one, and downloading the invoice PDF. There are no dead ends—the opaque fatura_id returned by listar_faturas is specifically designed to be used by baixar_fatura, closing the loop.