# Belong Australia MCP

> Belong Australia MCP lets you manage your mobile and broadband services through natural conversation. Instead of logging into the customer portal, you ask your agent for specific details—like checking current data usage or listing recent bills—and get instant answers. It pulls all your account information together so you don't have to jump between different websites to figure out what's wrong with a bill or an order.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** broadband, mobile-services, usage-tracking, invoicing, account-management, telecommunications

## Description

Managing telecom services usually means logging into a separate portal, digging through menus, and cross-referencing multiple pages just to get one answer. This MCP changes that process completely. You simply talk to your agent about your Belong account details. Need to know if you're over your data allowance? Just ask. Want to audit your spending by looking at the last three invoices? No problem. It pulls up those records instantly and can even give you a direct link to the PDF. The system handles all the complex lookups—from service status to payment methods—and gives you one clean summary. This entire catalog of telecom data is accessible through Vinkius, letting your AI client handle the heavy lifting so you don't have to.

## Tools

### get_account_balance
Checks your current total outstanding balance with Belong Australia.

### get_invoice_pdf
Finds and provides a direct link to view a specific billing invoice as a PDF.

### get_order_details
Pulls up detailed information about a particular service change or new equipment order.

### get_service_details
Retrieves specific operational details for any active mobile or broadband plan.

### get_usage_data
Gathers real-time data usage statistics for a chosen service line.

### get_user_profile
Retrieves basic identifying information about the account holder.

### list_invoices
Shows a list of all billing statements issued to the account recently.

### list_orders
Displays a summary of recent service modification or equipment orders placed.

### list_payment_methods
Lists all payment cards and methods saved on the account file.

### list_services
Provides a list of every current mobile and broadband service attached to the account.

## Prompt Examples

**Prompt:** 
```
List all active services in my Belong account.
```

**Response:** 
```
I've retrieved your services. You have 2 active plans: 'Mobile 20GB' (ID: svc_123) and 'Broadband Unlimited' (ID: svc_456). Which one would you like to check usage for?
```

**Prompt:** 
```
Check data usage for my mobile plan svc_123.
```

**Response:** 
```
You have used 12.5GB of your 20GB monthly allowance. You still have 7.5GB remaining for the current billing cycle.
```

**Prompt:** 
```
Show my recent account balance and payment methods.
```

**Response:** 
```
Your current account balance is $0.00. I found 1 saved payment method: 'Visa ending in 1234'. Your next bill is scheduled for April 15th.
```

## Capabilities

### Check account balance and payments
The agent retrieves your current account total and lists all saved payment methods.

### View service status and plans
It pulls a list of every active mobile or broadband plan attached to the account, giving you an overview of what's running.

### Track data consumption
You get real-time usage statistics for any specific service, telling you exactly how much allowance is left.

### Retrieve billing records
The agent lists recent invoices and retrieves direct PDF links for auditing purposes.

### Monitor orders and changes
It pulls up the status of any recent service modifications or new equipment orders.

## Use Cases

### The family needs to budget for the next month.
A parent asks their agent, 'What are our total bills and what services do we have?' The agent responds by listing all active services using `list_services` and then retrieves a summary of recent invoices via `list_invoices`, giving the full financial picture instantly.

### The small business owner needs to validate an expense report.
An accountant asks, 'Show me all network services used in Q1 and their corresponding bills.' The agent uses `list_services` for scope and then pulls specific PDFs using `get_invoice_pdf`, generating a clean record.

### The user is worried about overage fees.
A customer asks, 'How much data do I have left on my mobile plan?' The agent uses the `get_usage_data` tool to provide an exact figure, saving the user from having to check the app manually.

### The service was recently upgraded and the details are lost.
A customer asks, 'What did I order last week?' The agent uses `list_orders` first. If they need more info, it calls `get_order_details`, confirming the upgrade went through correctly.

## Benefits

- Stop hunting for PDFs. Instead of manually navigating the billing portal to find a specific bill, you can ask your agent to list recent invoices or even fetch a direct link using `get_invoice_pdf`.
- Know exactly what data you've used this cycle. Don't wait until the end-of-month statement; just ask for usage data and get real-time stats with `get_usage_data`.
- Get full account visibility without logging in. You can list all active services using `list_services` and immediately see if a plan needs adjustment, all from one conversation.
- Keep track of payments instantly. Instead of guessing which card is on file, ask your agent to display the saved payment methods with `list_payment_methods`. Plus, check your balance right away with `get_account_balance`.
- Track changes and orders effortlessly. You can list recent orders using `list_orders`, then drill down into specifics by calling `get_order_details`—all without clicking through multiple forms.

## How It Works

The bottom line is you talk to your agent like talking to a human customer service rep, and it handles all the backend lookups.

1. Subscribe to this MCP and enter your Belong OAuth Access Token.
2. Connect your preferred AI client (like Claude or Cursor) through Vinkius.
3. Ask the agent a question in plain language, such as 'What's my current data usage?'

## Frequently Asked Questions

**How do I check my account balance using get_account_balance?**
The agent immediately checks your current total against Belong's system and returns the exact dollar amount. This is a quick way to know if you're clear for payment.

**What does list_services actually show me?**
It provides a comprehensive rundown of every single mobile line or broadband connection tied to your account ID, so you see everything at a glance. This is great for household managers.

**How do I get the PDF link using get_invoice_pdf?**
You just need to ask for it and specify which bill period you want. The agent finds that specific invoice and sends back a direct, usable PDF link.

**If I upgraded my plan, how do I check the details using get_order_details?**
Just ask about the order ID or date. The tool pulls up all the specifics of that service change, confirming what was done and when.

**How do I use get_usage_data to check data consumption for a specific service ID?**
You must provide the Service ID and the relevant billing cycle when calling this tool. It returns real-time usage statistics, showing exactly how much data you've consumed against your total allowance.

**What information does list_payment_methods show about my saved cards?**
The tool lists all payment methods associated with your account. For security, it will only display masked details (like the last four digits) and the card type; it never shows the full number.

**What is required for authentication when setting up this MCP?**
To connect your Belong account, you must provide a valid OAuth Access Token. This token authorizes your AI client to access your account information through the established API connection.

**Can list_invoices retrieve billing records that are older than the recent history?**
The tool is designed to list your most recent invoices for quick review. While it doesn't pull historical archives, you can use the returned invoice details to find links or reference numbers needed for manual retrieval.

**Can I check how much data I have left on my mobile plan?**
Yes! Use the `get_usage_data` tool with your Service ID. Your agent will fetch the latest data consumption statistics directly from Belong.

**How do I see my last 3 invoices?**
Simply ask the agent to `list_invoices`. It will retrieve the history of recent bills linked to your account, showing dates and amounts.

**Does the integration allow me to change my internet plan?**
Currently, the toolset focuses on querying and monitoring (Read-Only). You can list and inspect services, usage, and invoices, but plan changes must be performed via the official Belong website or mobile app for security.