Skip to content

Tools and Transports

Read-only tools

get_billing_summary

Returns invoices_to_pay and failed_invoices counts.

get_last_reading and get_next_readings

Return the latest meter reading, or the scheduled company and customer reading dates. Dates use ISO YYYY-MM-DD strings.

get_water_shortages

Returns whether the portal reports a water shortage.

get_last_invoice_graph and get_billed_values_graph

Return labeled graph values. Amounts are decimal strings to preserve precision; the portal's display string is included when available.

Invoice history and pending-invoice tools are not exposed because the SDK temporarily disables those operations while the portal history request is investigated. All available tools are annotated as read-only; no tool accepts credentials or performs account mutations or payments.

stdio

stdio is the default for local MCP hosts that launch the server as a subprocess:

aquamatrix-simar-mcp

The host must provide SIMAR_NIF and SIMAR_PASSWORD in the server process environment. Do not print diagnostics to stdout; stdio carries MCP protocol messages.

Streamable HTTP

For an HTTP MCP client, run:

MCP_TRANSPORT=streamable-http aquamatrix-simar-mcp

The endpoint defaults to http://127.0.0.1:8000/mcp. HTTP has no server authentication, so loopback is the supported default. SSE is not provided; Streamable HTTP is the current standard transport.