AT&T DevEx

MVNX MCP

Voice Diagnostic Tools

Voice Diagnostic Tools

Check if Subscriber is Active for Voice

Determines if a subscriber's account is active, and if they are prepaid - if the prepaid state is active and has a balance for voice services 

The Check if Subscriber is Active for Voice tool determines if a subscriber's account is active, and if they are prepaid - if the prepaid state is active and has a balance for voice services.  Returns an active, active-prepaid, active-prepaid but no remaining balance, or not active.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_if_active_for_voice

  • Check that the subscriber status is Active
  • Check the subscriber prepaid status
  • Check the subscriber prepaid voice balance
  • Check the subscriber prepaid rate plan status

Partner (MVNO) ID, Subscriber number MSISDN number

Voice status: active, active-prepaid, active-prepaid but no remaining balance, or not active

"Check if the subscriber is listed as active for voice, and if they are prepaid, if prepaid is active and has a balance."

Check if Subscriber is Prepaid and Has a Positive Balance

Check if the subscriber is listed as active. If the subscriber is prepaid, verify the prepaid setting and balance

The Check if Subscriber is Prepaid and has a Positive Balance tool determines if a subscriber's account is active, and if they are prepaid - if the prepaid state is active and has a balance for voice services.  Returns an active, active-prepaid, active-prepaid but no remaining balance, or not active.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_if_prepaid_for_voice_and_has_a_positive_balance

  • Check that the subscriber prepaid status is Active
  • Check the subscriber prepaid rate plan status
  • Check the subscriber prepaid voice balance

Partner (MVNO) ID, Subscriber number MSISDN number

Prepaid status, rate plan status, prepaid voice balance

"Check the subscriber's prepaid setting, if prepaid is active and has a balance."

Check if Subscriber APN is Correct

Check if the subscriber account has the correct APN setting for voice services

The Check if Subscriber APN is Correct tool determines if a subscriber's account has proper APN setting.  If this setting is wrong, the subscriber's voice service will not work, and it sometimes happens that it is set to a 3G instead of 4G/5G setting.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_if_APN_is_correct

  • Retrieve the subscriber APN setting
  • Check the subscriber APN setting
  • Verify that the APN setting is correct for voice

Partner (MVNO) ID, Subscriber number MSISDN number

Status of APN setting (correct/incorrect) and APN type (3G/4G/5G)

"Check the subscriber account APN setting and make sure it is correct for voice service. "

Check if Subscriber IMSI is Correct

Check if the subscriber account has the correct IMSI setting for voice services

The Check if Subscriber IMSI is Correct tool determines if a subscriber's account has proper IMSI setting.  If this setting is wrong, the subscriber's voice service will not work.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_if_IMSI_is_correct

  • Check the subscriber IMSI setting
  • Verify that the IMSI setting is correct for voice

Partner (MVNO) ID, Subscriber number MSISDN number

Status of IMSI setting (correct/incorrect)

"Check the subscriber account IMSI setting and make sure it is correct for voice service. "

Check for Voice Roaming

Check if the subscriber's account has voice roaming and if it includes domestic, international, or both

The Check for Voice Roaming tool determines if a subscriber's account has voice roaming, and if so, if the roaming includes domestic, international, or both.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_for_voice_roaming

  • Check that the subscriber account is set for voice roaming
  • Determine which type of roaming is set for this subscriber

Partner (MVNO) ID, Subscriber number MSISDN number

Status of voice roaming setting and type of roaming (domestic, international, or both)

"Check if the subscriber's account is set for voice roaming"

Check All of a Subscriber's Voice Settings

Checks all the possible problems that may occur with a subscriber's voice settings

The Check All of a Subscriber's Voice Settings tool determines if a subscriber's account has proper settings, any of which could block or cause problems with voice service.  It checks active status, APN, IMSI, that the IMEI and ICCID / SIM id match, voice roaming, prepaid, prepaid status, and prepaid balance, registration status, and checks if the subscribers device is registered on the AT&T network, is compatible with the AT&T network, and is not blacklisted, and if the device is registered with an AT&T MVNO.  No additional MCP tools need to be called, the logic of this tool incorporates all those checks.   

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_all_voice_settings_on_a_subscriber

  • Check that the subscriber status is Active
  • Check APN
  • Check IMSI
  • Check for voice roaming
  • Check prepaid status and voice balance
  • Check registration status
  • Check subscriber's IMEI and ICCID
  • Check device compatibility with AT&T network
  • Check device not blacklisted
  • Check if device is on an AT&T MVNO provider

Partner (MVNO) ID, Subscriber number MSISDN number

Results of all subscriber setting checks: Active Status, APN, IMSI, Voice Roaming, Prepaid Status and Balance, IMEI, ICCID, Device Compatibility, Blacklist Status, MVNO Provider

"Check all of the subscriber voice settings to identify any setting that could block or cause problems with voice service."

Check Device Compatibility with AT&T Network

Check if the subscriber's device is compatible with AT&T's network

The Check Device Compatibility with AT&T Network tool checks if the subscriber's phone device is compatible with AT&T's network.  Returns a green, fully compatible, yellow, some capabilities of the device are not compatible with AT&T's network, and red, the device is not considered compatible but some functions may still work - but AT&T won't support its operation.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_device_compatibility

  • Checks a device's level of compatibility with the AT&T network

Subscriber's device IMEI


  • Green - fully compatible
  • Yellow - some capabilities of the device are not compatible with AT&T's network
  • Red - the device is not considered compatible but some functions may still work - but AT&T won't support its operation

"To diagnose subscriber problems, check their phone device compatibility."

Check Device Not Blacklisted

Check if the subscriber's device is reported stolen

The Check Device Not Blacklisted tool checks if the subscriber's phone device is considered blacklisted. Blacklisted means it is reported stolen, and no network is supposed to allow it to be activated. Returns the blacklisted status, and the date of the entry.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_device_not_blacklisted

  • Checks if a device was reported stolen

Subscriber's device IMEI

Blacklisted status, Date the status was updated to blacklisted

"To diagnose subscriber problems, check that their phone is not blacklisted."

Get Device Status

Get the raw results of the TMF 639, Inquire Device Status

The Check Device Status tool retrieves the subscriber's device information utilizing a TMF 639 Inquire Device Status API. Device status indicates type, compatibility with AT&T's network, blacklisted status, and more.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

get_device_status

  • Retrieve the device information
  • Retrieve the device status and AT&T compatibility settings

Subscriber's device IMEI

Full list of device information, such as type, compatibility with AT&T network, and blacklisted status

"To diagnose subscriber problems, let's see their device information."

Check Device on an AT&T MVNO

Check if the subscribers device is listed as having been ported onto the AT&T network / an AT&T MVNO

The Check Device on an AT&T MVNO tool checks if the subscriber's phone device is connected to an AT&T MVNO and the AT&T network.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_device_is_on_an_ATT_MVNO

  • Check if a device is on an AT&T MVNO provider

Subscriber's device IMEI

If the device is on an AT&T MVNO, returns the carrier name, returns a message if the device is not on an AT&T MVNO

"To diagnose subscriber problems, check that their device is on an AT&T MVNO provider."

Report Subscriber's Location

At this time, we can only report the subscribers location-at-which-they-subscribed. Real time query of location is not yet available, but coming soon.

The Report Subscriber's Location tool reports the location at which the subscriber registered their service, to know if their location is within a coverage zone, utilizing the TMF 761 API.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

report_subscribers_location

  • Retrieve the subscriber's registered location

Subscriber number MSISDN number

Service zip code and service area where the subscriber is registered

"Give me the location where this subscriber is registered."

Check Service Area

Check if a particular area is within the AT&T network's service area.

The Check Service Area tool checks if a particular zip code or a particular city + state is within AT&T's wireless service area, utilizing the TMF 674 API.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_service_area

  • Retrieve the market service area corresponding to a zip code or city

Zip code or city/state

JSON details of the market service area or "Area not found within AT&T's wireless service area."

"Check if this location is within the AT&T wireless service area."

Check the subscriber IMEI and SIM/ICCID

Check if the subscriber's listed IMEI and ICCID matches what is registered.

The Check the subscriber IMEI and SIM/ICCID tool checks if a subscriber's IMEI and ICCID (SIM number) registered in the network match the numbers being shared by the subscriber, utilizing the TMF 639 API.

Tool Name

Tool Functionality

Inputs

Outputs

Example Prompt

check_IMEI_and_ICCID

  • Check the subscriber's IMEI
  • Check the subscriber's ICCID (SIM)

Subscriber ID, subscriber IMEI, subscriber ICCID (SIM number)

JSON details of the subscriber's registered numbers

"Check that the subscriber's reported IMEI and ICCID/SIM match the numbers registered in the network."