Aussie Broadband
Monitor your NBN — usage, outages, billing, and diagnostics
Aussie Broadband ISP operations — usage monitoring, outage tracking, billing, and line diagnostics via the MyAussie API
Service Contract
Highlights
About
What it does
Aussie Broadband gives your AI agent structured access to your ABB account via the undocumented MyAussie portal API. Monitor broadband usage, track outages, review billing, check support tickets, and run NBN line diagnostics — all without opening the web portal.
Built on pyaussiebb (MIT, 6 years, powers the Home Assistant integration), the only well-maintained wrapper for the ABB API.
How it differs from other ISP tools
| This plugin | Home Assistant integration | Raw pyaussiebb | |
|---|---|---|---|
| Interface | MCP tools (any LLM agent) | HA entities + automations | Python library |
| Output | Token-optimised text | Sensor values | Raw dicts |
| Multi-account | Native (env var config) | One integration per account | Manual |
| Diagnostic safety | Double-gated (env + confirm) | Exposed as buttons | No gate |
| Auth transport | Bearer token + stdio | HA auth | None |
| Credential handling | Scrubbed from all output | HA secrets | Caller's responsibility |
This is the only MCP server for Aussie Broadband. There is no official ABB developer API or API key system — the MyAussie portal API is the only interface.
Multi-instance support
Designed for multi-instance deployment. Each instance authenticates independently with its own credentials. Use cases:
- Household + business — separate ABB accounts for home and office
- Property portfolio — different services at different addresses
- MSP / family — manage accounts for multiple people
Within a single instance, the ABB_ACCOUNTS env var supports multiple accounts with independent login sessions.
Token efficiency
The MyAussie API returns verbose JSON with nested objects. This plugin reformats everything into compact, pipe-delimited output:
- Service listing: ~50 tokens per service (vs ~500 raw)
- Usage summary: ~80 tokens including % used, billing period, human-readable units
- Outages: capped at 10 per section, descriptions truncated to 200 chars
Safety model
Read tools work immediately — usage, outages, billing, tickets, orders, services.
Diagnostic tools (connection check, loopback, port reset, line state) require dual gating:
ABB_DIAGNOSTICS_ENABLED=trueenvironment variable (persistent, set in plugin config)confirm=trueparameter on each call (per-invocation, prevents accidental execution)
Some diagnostic tests (port reset, kick connection) briefly interrupt your internet connection.
Authentication
Uses MyAussie portal credentials (email + password). The API returns a session cookie with TTL; pyaussiebb handles automatic re-login on expiry. MFA may be required for sensitive operations (plan changes) — this plugin documents MFA but does not bypass it.
Tool reference
| Tool | Type | What it does |
|---|---|---|
| abb_info | read | Health check — connection status, customer details, service count |
| abb_services | read | List all services with plan, tech type, speed tier |
| abb_service | read | Full detail for one service — address, POI, technology |
| abb_usage | read | Broadband usage: download, upload, remaining, % used |
| abb_telephony | read | Telephony usage: national, mobile, international, SMS |
| abb_outages | read | Network events, ABB outages, NBN outages (current + scheduled) |
| abb_billing | read | Transactions by month with configurable depth |
| abb_tickets | read | Support tickets: ref, status, subject, date |
| abb_orders | read | Pending orders: ID, status, type |
| abb_boltons | read | Service add-ons (data blocks, extras) |
| abb_tests | read | Available diagnostic tests + optional history |
| abb_run_test | gated | Execute a diagnostic test (loopback, linestate, port reset) |
Conformance
Setup
Enter your MyAussie portal credentials. These are the same email and password you use to log in at my.aussiebroadband.com.au. MFA may be prompted on first connection.
ABB_USERNAME Email required ABB_PASSWORD Password required secret ABB_DIAGNOSTICS_ENABLED Enable line diagnostics Prerequisites
- Aussie Broadband account (any plan)
- MyAussie portal access (email + password)
Scenarios
Call abb_services to list all services, then abb_usage on the primary broadband service to see download/upload/remaining. If usage is high relative to billing period, check abb_billing for recent charges.
Check abb_outages for any active network events or NBN outages. If no outages, check abb_tests for available diagnostics. Run abb_run_test with 'loopback' or 'linestate' to test line quality (requires diagnostics enabled).
Run abb_info to verify connectivity, then abb_outages to check for scheduled maintenance. Review abb_usage for billing period progress. Flag if usage exceeds 80% with more than 10 days remaining.
Use the Forge to design an automation pack powered by aussiebb-blade-mcp for isp operations.
Install
sidereal install aussiebb-blade-mcp