Wireless Choices Plan Finder

Compare Australian mobile, prepaid, mobile broadband and nbn plans listed on Wireless Choices

Should I use this

Quality & Safety

A
Description quality
95%
Schema completeness
83%
Naming quality
95%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~5,753Tokens (tool definitions)
~16.9 KBTypical response size
Significant attention impact (4.49% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "plan-finder": {
      "url": "https://mcp.wirelesschoices.com.au/mcp"
    }
  }
}

Remote endpoints

https://mcp.wirelesschoices.com.au/mcpstreamable-http

What it can do

Tool inventory

Tools (4)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_plans(plan_type, max_price_aud, min_data_gb, unlimited_data, network, ...)

Search current Australian mobile, prepaid, mobile broadband and nbn home internet plans from providers listed on Wireless Choices. Filter by price, included data, network, speed tier, contract and features. Results are ordered by lowest ongoing price among matching plans and each one carries the date it was last updated on Wireless Choices. Returns up to 10 plans, each with a link to its detail page; use offset for the next plans among the first 50 matches. Use list_providers first if you are unsure which providers exist.

Input Schema

{
  "type": "object",
  "properties": {
    "plan_type": {
      "type": "string",
      "enum": [
        "mobile",
        "prepaid",
        "mobile_broadband",
        "internet"
      ],
      "description": "Which catalogue to search"
    },
    "max_price_aud": {
      "type": "number",
      "minimum": 0,
      "maximum": 500,
      "description": "Ongoing price ceiling in AUD per billing period"
    },
    "min_data_gb": {
      "type": "number",
      "minimum": 0,
      "maximum": 5000,
      "description": "Minimum included data in GB; ignored for unlimited plans"
    },
    "unlimited_data": {
      "type": "boolean",
      "description": "Only plans with unlimited data"
    },
    "network": {
      "type": "string",
      "enum": [
        "telstra",
        "optus",
        "vodafone",
        "any"
      ],
      "description": "Mobile network the provider sells access to. Mobile, prepaid and mobile broadband only; not valid with internet. Use only when the user asks for plans on a network; a named provider goes in provider_slug"
    },
    "provider_slug": {
      "description": "Restrict to one provider. Use when the user names a provider, e.g. telstra, optus, boost-mobile; slugs are listed by list_providers",
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{0,199}$",
      "maxLength": 200
    },
    "features": {
      "type": "array",
      "maxItems": 4,
      "items": {
        "type": "string",
        "enum": [
          "5g",
          "esim",
          "data_rollover",
          "international_calls"
        ]
      },
      "description": "All listed features must be included. Mobile, prepaid and mobile broadband only; not valid with internet"
    },
    "expiry_days": {
      "type": "integer",
      "enum": [
        7,
        28,
        30,
        60,
        90,
        180,
        365
      ],
      "description": "Recharge length in days. Prepaid and mobile broadband only. 28 and 30 are different lengths and match exactly; 180 covers recharges of 180 to 186 days and 365 covers 360 to 365 days"
    },
    "contract_months": {
      "type": "integer",
      "enum": [
        0,
        12,
        24
      ],
      "description": "Contract term in months. 0 = month-to-month, with no fixed-term contract. Leave out unless the user asks about contract length"
    },
    "speed_tier": {
      "type": "integer",
      "enum": [
        12,
        25,
        50,
        100,
        250,
        500,
        750,
        1000,
        2000
      ],
      "description": "nbn speed tier in Mbps, internet only"
    },
    "technology": {
      "type": "string",
      "enum": [
        "nbn",
        "fixed_wireless",
        "home_5g",
        "home_4g",
        "satellite"
      ],
      "description": "Internet only"
    },
    "sort": {
      "type": "string",
      "enum": [
        "price",
        "data",
        "value"
      ],
      "description": "price = lowest ongoing price first (default); data = most data first; value = lowest price per GB first"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Plans to return, up to 10 (default 10)"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 40,
      "description": "Skip this many matches, to see the next plans in the same order. Pass next_offset from the previous result. Only the first 50 matches can be paged"
    }
  },
  "required": [
    "plan_type"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "search"
      ]
    },
    "cta_label": {
      "type": "string"
    },
    "plan_type": {
      "type": "string",
      "enum": [
        "mobile",
        "prepaid",
        "mobile_broadband",
        "internet"
      ]
    },
    "filters_applied": {
      "type": "object",
      "description": "The filters that were applied, echoed from the request"
    },
    "ranking_method": {
      "type": "string",
      "description": "The ordering applied to the results, in words"
    },
    "result_count": {
      "type": "integer",
      "description": "Plans returned, at most 10"
    },
    "total_matching": {
      "type": "integer",
      "description": "Plans that matched the filters"
    },
    "offset": {
      "type": "integer",
      "description": "Position of the first returned plan among the matches, from 0"
    },
    "next_offset": {
      "description": "Offset for the next plans; null when there are no more, or the 50-match paging limit is reached",
      "type": [
        "integer",
        "null"
      ]
    },
    "plans": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string"
          },
          "provider_slug": {
            "type": "string"
          },
          "provider_logo": {
            "type": [
              "string",
              "null"
            ]
          },
          "network": {
            "description": "Network the provider sells access to (mobile types) or technology label (internet)",
            "type": [
              "string",
              "null"
            ]
          },
          "plan_name": {
            "type": "string"
          },
          "plan_slug": {
            "type": "string"
          },
          "plan_type": {
            "type": "string",
            "enum": [
              "mobile",
              "prepaid",
              "mobile_broadband",
              "internet"
            ]
          },
          "price_aud": {
            "type": "number",
            "description": "Standard ongoing price per billing period in AUD"
          },
          "price_period": {
            "type": "string",
            "description": "\"per month\", \"per N days\", \"per N months\" or \"per recharge\""
          },
          "data": {
            "type": "object",
            "properties": {
              "gb": {
                "description": "Included data in GB; null when unlimited or not stated",
                "type": [
                  "number",
                  "null"
                ]
              },
              "unlimited": {
                "type": "boolean"
              },
              "rollover": {
                "type": "boolean"
              },
              "max_speed": {
                "description": "Full-speed cap, e.g. \"40Mbps\"; null when none is recorded",
                "type": [
                  "string",
                  "null"
                ]
              },
              "speed_after_allowance": {
                "description": "Throttle applied after the included data (postpaid and mobile broadband only)",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "gb",
              "unlimited",
              "rollover",
              "max_speed",
              "speed_after_allowance"
            ]
          },
          "speed": {
            "type": [
              "object",
              "null"
            ],
            "description": "Internet plans only. Exactly one of three forms is filled, chosen by basis: a typical evening speed, a typical evening range, or a provider-stated maximum",
            "properties": {
              "tier_mbps": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "tier_label": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "basis": {
                "description": "\"typical_busy_period\", \"typical_range\" or \"theoretical_max\"; null when not assessed",
                "type": [
                  "string",
                  "null"
                ]
              },
              "typical_evening_down_mbps": {
                "description": "Typical evening download speed. Filled only when the provider publishes a single busy-period figure",
                "type": [
                  "number",
                  "null"
                ]
              },
              "typical_evening_up_mbps": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "typical_range_down_min_mbps": {
                "description": "Low end of the published typical evening download range",
                "type": [
                  "number",
                  "null"
                ]
              },
              "typical_range_down_max_mbps": {
                "description": "High end of the published typical evening download range. Not a typical speed on its own",
                "type": [
                  "number",
                  "null"
                ]
              },
              "typical_range_up_mbps": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "stated_max_down_mbps": {
                "description": "Provider-stated maximum download speed, for plans with no published typical figure. Not a typical speed",
                "type": [
                  "number",
                  "null"
                ]
              },
              "stated_max_up_mbps": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          },
          "contract_months": {
            "description": "Contract term in months. 0 = month-to-month, with no fixed-term contract; null when not recorded",
            "type": [
              "integer",
              "null"
            ]
          },
          "modem_included": {
            "description": "True only when a modem is in the plan price. False does not mean the provider sells no modem; read modem_label",
            "type": [
              "boolean",
              "null"
            ]
          },
          "modem_label": {
            "description": "Internet plans: the modem position as recorded, e.g. \"BYO modem, or buy from $216\"",
            "type": [
              "string",
              "null"
            ]
          },
          "promo": {
            "type": [
              "object",
              "null"
            ],
            "description": "Current offer, present only while it is active on the Sydney date",
            "properties": {
              "price_aud": {
                "description": "Offer price per billing period; null for a bonus-data-only offer",
                "type": [
                  "number",
                  "null"
                ]
              },
              "months": {
                "description": "Offer length in months (monthly plans)",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "recharges": {
                "description": "Offer length in recharges (prepaid, mobile broadband)",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "bonus_data": {
                "description": "Bonus data, e.g. \"40GB\"",
                "type": [
                  "string",
                  "null"
                ]
              },
              "bonus_recharges": {
                "description": "Recharges the bonus applies to",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "ends_on": {
                "description": "Offer end date, ISO date",
                "type": [
                  "string",
                  "null"
                ]
              },
              "activate_by": {
                "description": "Activation deadline, ISO date",
                "type": [
                  "string",
                  "null"
                ]
              },
              "customer_type": {
                "description": "\"new\", \"all\" or a provider-specific value",
                "type": [
                  "string",
                  "null"
                ]
              },
              "eligibility": {
                "description": "Eligibility condition as published by the provider",
                "type": [
                  "string",
                  "null"
                ]
              },
              "terms": {
                "description": "Offer terms as published by the provider",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "price_rise": {
            "type": [
              "object",
              "null"
            ],
            "description": "Announced price rise not yet in effect",
            "properties": {
              "new_price_aud": {
                "type": "number"
              },
              "from": {
                "type": "string"
              },
              "note": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "first_12_months_cost_aud": {
            "description": "Monthly postpaid and internet plans only, never prepaid: offer months at the offer price, the rest at the standard price, with any announced price rise counted from its start date",
            "type": [
              "number",
              "null"
            ]
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "updated_on": {
            "description": "Date Wireless Choices last recorded a change to the plan, ISO date",
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "description": "Plan page on wirelesschoices.com.au with UTM parameters"
          },
          "inclusions": {
            "type": "object",
            "description": "Present on get_plan and compare_plans",
            "properties": {
              "national_calls_sms": {
                "type": [
                  "boolean",
                  "string",
                  "null"
                ]
              },
              "international_calls": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "international_sms": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "international_countries": {
                "type": [
                  "string",
                  "number",
                  "null"
                ]
              },
              "roaming": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "excess_data": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "notes": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "modem": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "connection_types": {
                "type": [
                  "string",
                  "array",
                  "null"
                ]
              },
              "cgnat": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "required": [
          "provider",
          "provider_slug",
          "plan_name",
          "plan_slug",
          "plan_type",
          "price_aud",
          "price_period",
          "data",
          "features",
          "url"
        ]
      }
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "label",
          "url"
        ]
      }
    },
    "coverage_note": {
      "type": "string"
    },
    "contract_note": {
      "type": "string",
      "description": "Present only when the search filtered on contract length: how many listed plans of this type have no fixed-term contract"
    },
    "disclosure": {
      "type": "string"
    },
    "catalogue_updated": {
      "type": "string",
      "description": "Date the catalogue copy was generated, ISO date"
    },
    "error": {
      "type": "string",
      "description": "Error code, present only on an error result"
    },
    "message": {
      "type": "string",
      "description": "User-facing error message, present only on an error result"
    }
  }
}
🟢get_plan(plan_type, provider_slug, plan_slug)

Return the details of one plan from Wireless Choices by plan type, provider slug and plan slug, including inclusions, current promotion terms and the link to its detail page. Use the slugs returned by search_plans or list_providers.

Input Schema

{
  "type": "object",
  "properties": {
    "plan_type": {
      "type": "string",
      "enum": [
        "mobile",
        "prepaid",
        "mobile_broadband",
        "internet"
      ]
    },
    "provider_slug": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{0,199}$",
      "maxLength": 200
    },
    "plan_slug": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{0,199}$",
      "maxLength": 200
    }
  },
  "required": [
    "plan_type",
    "provider_slug",
    "plan_slug"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "detail"
      ]
    },
    "cta_label": {
      "type": "string"
    },
    "plan": {
      "type": "object",
      "properties": {
        "provider": {
          "type": "string"
        },
        "provider_slug": {
          "type": "string"
        },
        "provider_logo": {
          "type": [
            "string",
            "null"
          ]
        },
        "network": {
          "description": "Network the provider sells access to (mobile types) or technology label (internet)",
          "type": [
            "string",
            "null"
          ]
        },
        "plan_name": {
          "type": "string"
        },
        "plan_slug": {
          "type": "string"
        },
        "plan_type": {
          "type": "string",
          "enum": [
            "mobile",
            "prepaid",
            "mobile_broadband",
            "internet"
          ]
        },
        "price_aud": {
          "type": "number",
          "description": "Standard ongoing price per billing period in AUD"
        },
        "price_period": {
          "type": "string",
          "description": "\"per month\", \"per N days\", \"per N months\" or \"per recharge\""
        },
        "data": {
          "type": "object",
          "properties": {
            "gb": {
              "description": "Included data in GB; null when unlimited or not stated",
              "type": [
                "number",
                "null"
              ]
            },
            "unlimited": {
              "type": "boolean"
            },
            "rollover": {
              "type": "boolean"
            },
            "max_speed": {
              "description": "Full-speed cap, e.g. \"40Mbps\"; null when none is recorded",
              "type": [
                "string",
                "null"
              ]
            },
            "speed_after_allowance": {
              "description": "Throttle applied after the included data (postpaid and mobile broadband only)",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "gb",
            "unlimited",
            "rollover",
            "max_speed",
            "speed_after_allowance"
          ]
        },
        "speed": {
          "type": [
            "object",
            "null"
          ],
          "description": "Internet plans only. Exactly one of three forms is filled, chosen by basis: a typical evening speed, a typical evening range, or a provider-stated maximum",
          "properties": {
            "tier_mbps": {
              "type": [
                "integer",
                "null"
              ]
            },
            "tier_label": {
              "type": [
                "string",
                "null"
              ]
            },
            "basis": {
              "description": "\"typical_busy_period\", \"typical_range\" or \"theoretical_max\"; null when not assessed",
              "type": [
                "string",
                "null"
              ]
            },
            "typical_evening_down_mbps": {
              "description": "Typical evening download speed. Filled only when the provider publishes a single busy-period figure",
              "type": [
                "number",
                "null"
              ]
            },
            "typical_evening_up_mbps": {
              "type": [
                "number",
                "null"
              ]
            },
            "typical_range_down_min_mbps": {
              "description": "Low end of the published typical evening download range",
              "type": [
                "number",
                "null"
              ]
            },
            "typical_range_down_max_mbps": {
              "description": "High end of the published typical evening download range. Not a typical speed on its own",
              "type": [
                "number",
                "null"
              ]
            },
            "typical_range_up_mbps": {
              "type": [
                "number",
                "null"
              ]
            },
            "stated_max_down_mbps": {
              "description": "Provider-stated maximum download speed, for plans with no published typical figure. Not a typical speed",
              "type": [
                "number",
                "null"
              ]
            },
            "stated_max_up_mbps": {
              "type": [
                "number",
                "null"
              ]
            }
          }
        },
        "contract_months": {
          "description": "Contract term in months. 0 = month-to-month, with no fixed-term contract; null when not recorded",
          "type": [
            "integer",
            "null"
          ]
        },
        "modem_included": {
          "description": "True only when a modem is in the plan price. False does not mean the provider sells no modem; read modem_label",
          "type": [
            "boolean",
            "null"
          ]
        },
        "modem_label": {
          "description": "Internet plans: the modem position as recorded, e.g. \"BYO modem, or buy from $216\"",
          "type": [
            "string",
            "null"
          ]
        },
        "promo": {
          "type": [
            "object",
            "null"
          ],
          "description": "Current offer, present only while it is active on the Sydney date",
          "properties": {
            "price_aud": {
              "description": "Offer price per billing period; null for a bonus-data-only offer",
              "type": [
                "number",
                "null"
              ]
            },
            "months": {
              "description": "Offer length in months (monthly plans)",
              "type": [
                "integer",
                "null"
              ]
            },
            "recharges": {
              "description": "Offer length in recharges (prepaid, mobile broadband)",
              "type": [
                "integer",
                "null"
              ]
            },
            "bonus_data": {
              "description": "Bonus data, e.g. \"40GB\"",
              "type": [
                "string",
                "null"
              ]
            },
            "bonus_recharges": {
              "description": "Recharges the bonus applies to",
              "type": [
                "integer",
                "null"
              ]
            },
            "ends_on": {
              "description": "Offer end date, ISO date",
              "type": [
                "string",
                "null"
              ]
            },
            "activate_by": {
              "description": "Activation deadline, ISO date",
              "type": [
                "string",
                "null"
              ]
            },
            "customer_type": {
              "description": "\"new\", \"all\" or a provider-specific value",
              "type": [
                "string",
                "null"
              ]
            },
            "eligibility": {
              "description": "Eligibility condition as published by the provider",
              "type": [
                "string",
                "null"
              ]
            },
            "terms": {
              "description": "Offer terms as published by the provider",
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "price_rise": {
          "type": [
            "object",
            "null"
          ],
          "description": "Announced price rise not yet in effect",
          "properties": {
            "new_price_aud": {
              "type": "number"
            },
            "from": {
              "type": "string"
            },
            "note": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "first_12_months_cost_aud": {
          "description": "Monthly postpaid and internet plans only, never prepaid: offer months at the offer price, the rest at the standard price, with any announced price rise counted from its start date",
          "type": [
            "number",
            "null"
          ]
        },
        "features": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "updated_on": {
          "description": "Date Wireless Choices last recorded a change to the plan, ISO date",
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "type": "string",
          "description": "Plan page on wirelesschoices.com.au with UTM parameters"
        },
        "inclusions": {
          "type": "object",
          "description": "Present on get_plan and compare_plans",
          "properties": {
            "national_calls_sms": {
              "type": [
                "boolean",
                "string",
                "null"
              ]
            },
            "international_calls": {
              "type": [
                "string",
                "null"
              ]
            },
            "international_sms": {
              "type": [
                "string",
                "null"
              ]
            },
            "international_countries": {
              "type": [
                "string",
                "number",
                "null"
              ]
            },
            "roaming": {
              "type": [
                "string",
                "null"
              ]
            },
            "excess_data": {
              "type": [
                "string",
                "null"
              ]
            },
            "notes": {
              "type": [
                "string",
                "null"
              ]
            },
            "modem": {
              "type": [
                "string",
                "null"
              ]
            },
            "connection_types": {
              "type": [
                "string",
                "array",
                "null"
              ]
            },
            "cgnat": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      },
      "required": [
        "provider",
        "provider_slug",
        "plan_name",
        "plan_slug",
        "plan_type",
        "price_aud",
        "price_period",
        "data",
        "features",
        "url"
      ]
    },
    "disclosure": {
      "type": "string"
    },
    "result_count": {
      "type": "integer"
    },
    "listing_url": {
      "type": "string",
      "description": "Listing page to try instead, present only when the plan was not found"
    },
    "error": {
      "type": "string",
      "description": "Error code, present only on an error result"
    },
    "message": {
      "type": "string",
      "description": "User-facing error message, present only on an error result"
    }
  }
}
🟢compare_plans(plans)

Compare two to four plans from Wireless Choices side by side on price, data, network or technology, speed, contract and inclusions. Pass the plan type, provider slug and plan slug for each plan, as returned by search_plans.

Input Schema

{
  "type": "object",
  "properties": {
    "plans": {
      "type": "array",
      "minItems": 2,
      "maxItems": 4,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "plan_type",
          "provider_slug",
          "plan_slug"
        ],
        "properties": {
          "plan_type": {
            "type": "string",
            "enum": [
              "mobile",
              "prepaid",
              "mobile_broadband",
              "internet"
            ]
          },
          "provider_slug": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9-]{0,199}$",
            "maxLength": 200
          },
          "plan_slug": {
            "type": "string",
            "pattern": "^[a-z0-9][a-z0-9-]{0,199}$",
            "maxLength": 200
          }
        }
      }
    }
  },
  "required": [
    "plans"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "compare"
      ]
    },
    "cta_label": {
      "type": "string"
    },
    "plans": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string"
          },
          "provider_slug": {
            "type": "string"
          },
          "provider_logo": {
            "type": [
              "string",
              "null"
            ]
          },
          "network": {
            "description": "Network the provider sells access to (mobile types) or technology label (internet)",
            "type": [
              "string",
              "null"
            ]
          },
          "plan_name": {
            "type": "string"
          },
          "plan_slug": {
            "type": "string"
          },
          "plan_type": {
            "type": "string",
            "enum": [
              "mobile",
              "prepaid",
              "mobile_broadband",
              "internet"
            ]
          },
          "price_aud": {
            "type": "number",
            "description": "Standard ongoing price per billing period in AUD"
          },
          "price_period": {
            "type": "string",
            "description": "\"per month\", \"per N days\", \"per N months\" or \"per recharge\""
          },
          "data": {
            "type": "object",
            "properties": {
              "gb": {
                "description": "Included data in GB; null when unlimited or not stated",
                "type": [
                  "number",
                  "null"
                ]
              },
              "unlimited": {
                "type": "boolean"
              },
              "rollover": {
                "type": "boolean"
              },
              "max_speed": {
                "description": "Full-speed cap, e.g. \"40Mbps\"; null when none is recorded",
                "type": [
                  "string",
                  "null"
                ]
              },
              "speed_after_allowance": {
                "description": "Throttle applied after the included data (postpaid and mobile broadband only)",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "gb",
              "unlimited",
              "rollover",
              "max_speed",
              "speed_after_allowance"
            ]
          },
          "speed": {
            "type": [
              "object",
              "null"
            ],
            "description": "Internet plans only. Exactly one of three forms is filled, chosen by basis: a typical evening speed, a typical evening range, or a provider-stated maximum",
            "properties": {
              "tier_mbps": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "tier_label": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "basis": {
                "description": "\"typical_busy_period\", \"typical_range\" or \"theoretical_max\"; null when not assessed",
                "type": [
                  "string",
                  "null"
                ]
              },
              "typical_evening_down_mbps": {
                "description": "Typical evening download speed. Filled only when the provider publishes a single busy-period figure",
                "type": [
                  "number",
                  "null"
                ]
              },
              "typical_evening_up_mbps": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "typical_range_down_min_mbps": {
                "description": "Low end of the published typical evening download range",
                "type": [
                  "number",
                  "null"
                ]
              },
              "typical_range_down_max_mbps": {
                "description": "High end of the published typical evening download range. Not a typical speed on its own",
                "type": [
                  "number",
                  "null"
                ]
              },
              "typical_range_up_mbps": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "stated_max_down_mbps": {
                "description": "Provider-stated maximum download speed, for plans with no published typical figure. Not a typical speed",
                "type": [
                  "number",
                  "null"
                ]
              },
              "stated_max_up_mbps": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          },
          "contract_months": {
            "description": "Contract term in months. 0 = month-to-month, with no fixed-term contract; null when not recorded",
            "type": [
              "integer",
              "null"
            ]
          },
          "modem_included": {
            "description": "True only when a modem is in the plan price. False does not mean the provider sells no modem; read modem_label",
            "type": [
              "boolean",
              "null"
            ]
          },
          "modem_label": {
            "description": "Internet plans: the modem position as recorded, e.g. \"BYO modem, or buy from $216\"",
            "type": [
              "string",
              "null"
            ]
          },
          "promo": {
            "type": [
              "object",
              "null"
            ],
            "description": "Current offer, present only while it is active on the Sydney date",
            "properties": {
              "price_aud": {
                "description": "Offer price per billing period; null for a bonus-data-only offer",
                "type": [
                  "number",
                  "null"
                ]
              },
              "months": {
                "description": "Offer length in months (monthly plans)",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "recharges": {
                "description": "Offer length in recharges (prepaid, mobile broadband)",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "bonus_data": {
                "description": "Bonus data, e.g. \"40GB\"",
                "type": [
                  "string",
                  "null"
                ]
              },
              "bonus_recharges": {
                "description": "Recharges the bonus applies to",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "ends_on": {
                "description": "Offer end date, ISO date",
                "type": [
                  "string",
                  "null"
                ]
              },
              "activate_by": {
                "description": "Activation deadline, ISO date",
                "type": [
                  "string",
                  "null"
                ]
              },
              "customer_type": {
                "description": "\"new\", \"all\" or a provider-specific value",
                "type": [
                  "string",
                  "null"
                ]
              },
              "eligibility": {
                "description": "Eligibility condition as published by the provider",
                "type": [
                  "string",
                  "null"
                ]
              },
              "terms": {
                "description": "Offer terms as published by the provider",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "price_rise": {
            "type": [
              "object",
              "null"
            ],
            "description": "Announced price rise not yet in effect",
            "properties": {
              "new_price_aud": {
                "type": "number"
              },
              "from": {
                "type": "string"
              },
              "note": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "first_12_months_cost_aud": {
            "description": "Monthly postpaid and internet plans only, never prepaid: offer months at the offer price, the rest at the standard price, with any announced price rise counted from its start date",
            "type": [
              "number",
              "null"
            ]
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "updated_on": {
            "description": "Date Wireless Choices last recorded a change to the plan, ISO date",
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "description": "Plan page on wirelesschoices.com.au with UTM parameters"
          },
          "inclusions": {
            "type": "object",
            "description": "Present on get_plan and compare_plans",
            "properties": {
              "national_calls_sms": {
                "type": [
                  "boolean",
                  "string",
                  "null"
                ]
              },
              "international_calls": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "international_sms": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "international_countries": {
                "type": [
                  "string",
                  "number",
                  "null"
                ]
              },
              "roaming": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "excess_data": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "notes": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "modem": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "connection_types": {
                "type": [
                  "string",
                  "array",
                  "null"
                ]
              },
              "cgnat": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "required": [
          "provider",
          "provider_slug",
          "plan_name",
          "plan_slug",
          "plan_type",
          "price_aud",
          "price_period",
          "data",
          "features",
          "url"
        ]
      }
    },
    "not_found": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "disclosure": {
      "type": "string"
    },
    "result_count": {
      "type": "integer"
    },
    "error": {
      "type": "string",
      "description": "Error code, present only on an error result"
    },
    "message": {
      "type": "string",
      "description": "User-facing error message, present only on an error result"
    }
  }
}
🟢list_providers(plan_type)

List the telco providers currently listed on Wireless Choices, with the network each one sells access to and how many plans of each type are listed. Use this to resolve a provider name to its slug before calling search_plans or get_plan.

Input Schema

{
  "type": "object",
  "properties": {
    "plan_type": {
      "type": "string",
      "enum": [
        "mobile",
        "prepaid",
        "mobile_broadband",
        "internet"
      ]
    }
  },
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "providers"
      ]
    },
    "providers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "network": {
            "description": "\"Telstra network\", \"Telstra Wholesale network\", \"Optus network\", \"Vodafone network\", a host network with a qualifier in brackets, \"nbn\", or null",
            "type": [
              "string",
              "null"
            ]
          },
          "plan_counts": {
            "type": "object",
            "properties": {
              "mobile": {
                "type": "integer"
              },
              "prepaid": {
                "type": "integer"
              },
              "mobile_broadband": {
                "type": "integer"
              },
              "internet": {
                "type": "integer"
              }
            },
            "required": [
              "mobile",
              "prepaid",
              "mobile_broadband",
              "internet"
            ]
          }
        },
        "required": [
          "name",
          "slug",
          "network",
          "plan_counts"
        ]
      }
    },
    "result_count": {
      "type": "integer"
    },
    "disclosure": {
      "type": "string"
    },
    "error": {
      "type": "string",
      "description": "Error code, present only on an error result"
    },
    "message": {
      "type": "string",
      "description": "User-facing error message, present only on an error result"
    }
  }
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded4 tools