General Troubleshooting Tools

General Tools Banner

Get MVNO Subscriber Profile

Retrieves a complete list of all telecom subscriber information known by the network about a specific subscriber

The get_subscriber_profile tool retrieves a subscriber profile using the subscriber number as ID. Returns a complete list of all telecom subscriber information known by the network about this subscriber including the rate plan, all the services codes, the subscriber status, contract terms, contact information, price plan information, additional offerings, solicitation indicators, commission, discount, unbilled voice usage, and device information.

Tool Functionality

  • Retrieve the subscriber status
  • Retrieve the subscriber contract terms
  • Retrieve the subscriber contact information
  • Retrieve the subscriber pricing and billing information
  • Retrieve the subscriber device information

Inputs

Partner (MVNO) ID, Subscriber number, MSISDN number

Outputs

Subscriber status, contract terms, contact information, price plan information, additional offerings, solicitation indicators, commission, discount, unbilled voice usage, and device information

Example Prompt

"Give me full details about this subscriber."

APIs

TMF 637


Get MVNO Subscriber Enabled Services

Checks which voice and data services are activated for this subscriber

The get_enabled_services tool retrieves a subscriber's Home Location Register (HLR) for the phone registration information using the subscriber number as ID.  Returns the telecom subscriber HLR information known by the network about this subscriber including indicators voice enabled and data enabled for 2G, 3G and 4G (LTE), if voice or data roaming, call waiting, call forwarding are allowed.

Tool Functionality

  • Check if the subscriber is enabled for voice
  • Check which data types (2G, 3G, 4G) are enabled for the subscriber
  • Check if subscriber is enabled for voice roaming and data roaming
  • Check if the subscriber has call waiting and call forwarding enabled

Inputs

Partner (MVNO) ID, Subscriber number, MSISDN number

Outputs

Voice enabled, Data enabled, Data type (2G, 3G, 4G LTE), voice roaming, data roaming, call waiting, call forwarding

Example Prompt

"Check which services are enabled for this subscriber."

APIs

TMF 640


Get MVNO Subscriber Prepay Balance and Status

Retrieves the subscriber's account details in the prepaid platform

The get_prepay_balance_and_status tool retrieves a subscribers monetary balance and basic subscription information, including activation and cancellation date, if prepay remaining balance, rate plan, auto renew setting, and if they have add on plans such as international roaming. 

Tool Functionality

  • Retrieve the subscriber basic subscription information, including activation and cancellation date
  • Retrieve the subscriber rate plan and auto renew setting
  • Retrieve the subscriber add on plans such as international roaming

Inputs

Partner (MVNO) ID, Subscriber number, MSISDN number

Outputs

Monetary balance and basic subscription information

Example Prompt

"Give me full details about this subscriber's prepaid balance and status."

APIs

TMF 654


Inquire OTA Profile

Retrieves the OTA (over the air profile) for a subscriber by subscriber number or by ICCID

The inquire_ota_profile tool retrieves details of a subscriber’s over the air services as part of subscriber troubleshooting. 

Inputs

Subscriber number or ICCID

Outputs

Returns a JSON with a list of various service indicators

Example Prompt

"Give me an over the air profile of this subscriber."

APIs

TMF 639


Inquire SIM Status

Retrieves the current status of a SIM card using its ICCID (Integrated Circuit Card Identifier)

The inquire_sim_satus tool retrieves status of a SIM card as part of subscriber troubleshooting. 

Tool Functionality

Verifies SIM inventory and provisioning status

Input

SIM ICCID serial number

Outputs

Status:

  • SIM is available for activation
  • currently assigned to a subscriber
  • disconnected
  • not yet loaded into inventor
  • permanently disabled

Example Prompt

"Give me the status of this SIM."

APIs

TMF 639