Servidor MCP

SIMcloud

za.co.simcloud/simcloud
Comunicación Pagos y fintech Público y accesible MCP 2026-07-28

Qué hace este MCP

Enables South African airtime, mobile data, SMS, electricity, and VAS purchases, along with wallet, transaction, and network lookup functions.

check_electricity_meter
Check electricity meter
Use this before create_electricity_order to check whether a prepaid electricity meter is supported. This does not buy electricity or spend wallet funds.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['meter_number'], 'properties': {'meter_number': {'type': 'string', 'description': 'Prepaid electricity meter number to validate.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
create_airtime_order
Send South African airtime
Use this when an authenticated SIMcloud user asks to send or recharge prepaid airtime to a South African mobile number on MTN, Vodacom, Cell C or Telkom. Confirm the MSISDN, network, rand amount and reference before calling. This spends wallet funds and queues an irreversible external transaction. Never automatically retry an ambiguous result. Duplicate same-MSISDN-and-amount requests inside 5 minutes return HTTP 409.
Destructivo Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['msisdn', 'network', 'amount', 'reference'], 'properties': {'amount': {'type': 'number', 'maximum': 999, 'minimum': 2, 'description': 'Airtime amount in South African rand, from R2 to R999.'}, 'msisdn': {'type': 'string', 'description': 'South African mobile number to recharge, for example 0821234567 or +27821234567.'}, 'network': {'enum': ['mtn', 'p-mtn', 'vodacom', 'p-vodacom', 'cellc', 'cell-c', 'cell c', 'p-cellc', 'telkom', 'heita', 'p-heita'], 'type': 'string', 'description': 'Supported South African airtime network name or SIMcloud internal code.'}, 'reference': {'type': 'string', 'minLength': 1, 'description': 'User or system reference for this airtime order.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
create_data_order
Create data order
Use this when an authenticated SIMcloud user asks to send a confirmed South African mobile data bundle. Call list_data_products first and use an available network and sell value. This spends wallet funds and queues an irreversible external transaction. Never automatically retry an ambiguous result. Duplicate same-MSISDN-and-amount requests inside 5 minutes return HTTP 409.
Destructivo Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['msisdn', 'network', 'amount', 'reference'], 'properties': {'amount': {'type': 'number', 'description': 'Exact data bundle sell value returned by list_data_products.', 'exclusiveMinimum': 0}, 'msisdn': {'type': 'string', 'description': 'South African mobile number to recharge, for example 0821234567 or +27821234567.'}, 'network': {'enum': ['mtn', 'pd-mtn', 'vodacom', 'pd-vodacom', 'cellc', 'cell-c', 'cell c', 'pd-cellc', 'telkom', 'heita', 'pd-heita'], 'type': 'string', 'description': 'Supported South African data network name or SIMcloud internal code returned by list_data_products.'}, 'reference': {'type': 'string', 'minLength': 1, 'description': 'User or system reference for this data order.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
create_electricity_order
Create electricity order
Use this when an authenticated SIMcloud user asks to buy prepaid electricity for a meter already confirmed with check_electricity_meter. Confirm the meter, rand amount, reference and SMS recipient before calling. This spends wallet funds and submits an irreversible external transaction; do not automatically retry an ambiguous result.
Destructivo Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['meter_number', 'amount', 'client_reference', 'recipient'], 'properties': {'amount': {'type': 'integer', 'maximum': 1000, 'minimum': 55, 'description': 'Electricity purchase amount in whole South African rand (no cents), from R55 to R1000.'}, 'recipient': {'type': 'string', 'description': 'Recipient mobile number for voucher notifications.'}, 'meter_number': {'type': 'string', 'maxLength': 50, 'description': 'Prepaid electricity meter number previously checked with check_electricity_meter.'}, 'client_reference': {'type': 'string', 'description': 'User or system reference for this electricity order.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
create_vas_order
Create VAS order
Use this when an authenticated SIMcloud user asks to buy a confirmed VAS voucher. Call list_vas_products first and use an available product and denomination. This spends wallet funds and queues an irreversible external transaction; do not automatically retry an ambiguous result.
Destructivo Acceso externo
Esquema de entrada
{'type': 'object', 'anyOf': [{'required': ['product_id']}, {'required': ['voucher_type']}], 'required': ['amount', 'reference'], 'properties': {'amount': {'type': 'number', 'exclusiveMinimum': 0}, 'reference': {'type': 'string', 'maxLength': 200}, 'product_id': {'type': 'integer', 'minimum': 1, 'description': 'SIMcloud VAS product ID. Required when voucher_type is not supplied.'}, 'voucher_type': {'type': 'string', 'description': 'Exact VAS voucher type or slug. Required when product_id is not supplied.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
get_airtime_order
Get airtime order
Use this after create_airtime_order, or after an ambiguous create result, to fetch the authenticated account airtime order by request_id or orderno.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'anyOf': [{'required': ['request_id']}, {'required': ['orderno']}], 'required': [], 'properties': {'orderno': {'type': 'string', 'description': 'SIMcloud platform order number returned during processing.'}, 'request_id': {'type': 'integer', 'minimum': 1, 'description': 'SIMcloud request identifier returned when the order was queued.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
get_data_order
Get data order
Use this after create_data_order, or after an ambiguous create result, to fetch the authenticated account data order by request_id or orderno.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'anyOf': [{'required': ['request_id']}, {'required': ['orderno']}], 'required': [], 'properties': {'orderno': {'type': 'string', 'description': 'SIMcloud platform order number returned during processing.'}, 'request_id': {'type': 'integer', 'minimum': 1, 'description': 'SIMcloud request identifier returned when the order was queued.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
get_electricity_order
Get electricity order
Use this after create_electricity_order, or after an ambiguous create result, to fetch an authenticated account electricity order by order_id, client_reference or order_reference_id.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'anyOf': [{'required': ['order_id']}, {'required': ['client_reference']}, {'required': ['order_reference_id']}], 'required': [], 'properties': {'order_id': {'type': 'integer', 'minimum': 1}, 'client_reference': {'type': 'string'}, 'order_reference_id': {'type': 'string'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
get_sms_status
Get SMS status
Use this after send_sms to fetch the delivery status of an authenticated account SMS by sms_id.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['sms_id'], 'properties': {'sms_id': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
get_transaction_history
Get transaction history
Use this to retrieve read-only transaction history for the authenticated SIMcloud account across web, CSV, recurring and API airtime, data, SMS, VAS and electricity activity. Require a date range; optionally filter one or more services with a comma-separated type value. SMS is successful only after a delivery receipt.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['date_from', 'date_to'], 'properties': {'type': {'type': 'string', 'description': 'Optional comma-separated service filter: airtime, data, electricity, vas and sms.'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string', 'description': 'Opaque cursor returned by the previous result. Keep the same date range and type filter.'}, 'date_to': {'type': 'string', 'format': 'date', 'description': 'Inclusive end date in YYYY-MM-DD format. The maximum range is 90 days.'}, 'date_from': {'type': 'string', 'format': 'date', 'description': 'Inclusive start date in YYYY-MM-DD format, interpreted in Africa/Johannesburg time.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
get_vas_order
Get VAS order
Use this after create_vas_order, or after an ambiguous create result, to fetch an authenticated account VAS order by order_id or transaction_id.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'anyOf': [{'required': ['order_id']}, {'required': ['transaction_id']}], 'required': [], 'properties': {'order_id': {'type': 'integer', 'minimum': 1}, 'transaction_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
get_wallet_balance
Get wallet balance
Use this before a wallet-funded SIMcloud transaction or when the user asks for their available SIMcloud balance. Returns the authenticated account wallet balance and does not spend funds.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': [], 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
list_data_products
List data products
Use this before create_data_order to list the current SIMcloud data bundle products and exact sell values available for API ordering, optionally filtered by South African network.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'network': {'type': 'string', 'description': 'Optional friendly network name or internal code, for example mtn or pd-mtn.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
list_vas_products
List VAS products
Use this before create_vas_order to list active SIMcloud VAS voucher products and their available denominations.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': [], 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
lookup_network
Look up mobile network
Use this when the user needs to identify the South African mobile network for a number before sending airtime, data or SMS. The lookup is recorded in the authenticated account history.
Esquema de entrada
{'type': 'object', 'required': ['msisdn'], 'properties': {'msisdn': {'type': 'string', 'description': 'South African mobile number, for example 0821234567.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
register_simcloud_user
Register a SIMcloud user
Create a normal SIMcloud account under the authenticated account for a client application user. Confirm that the person consents to account creation and that their cell number, email and password are correct before calling. The response contains the child account API token, which must be stored securely and used only for that child account.
Destructivo Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['first_name', 'last_name', 'cell', 'email', 'password'], 'properties': {'cell': {'type': 'string', 'pattern': '^0[0-9]{9}$', 'description': '10-digit South African mobile number beginning with 0.'}, 'email': {'type': 'string', 'format': 'email'}, 'vatno': {'type': 'string'}, 'address': {'type': 'string'}, 'password': {'type': 'string', 'minLength': 1, 'description': "The new user's SIMcloud login password. Do not log or display it after this call."}, 'id_number': {'type': 'string', 'description': 'Optional valid South African ID number.'}, 'last_name': {'type': 'string', 'minLength': 1}, 'first_name': {'type': 'string', 'minLength': 1}, 'business_reg': {'type': 'string'}, 'business_name': {'type': 'string'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
send_sms
Send SMS
Use this when an authenticated SIMcloud user asks to send a confirmed SMS to a South African recipient. Confirm the final recipient and message before calling. Sending is an irreversible external action and may spend wallet funds; do not automatically retry an ambiguous result.
Destructivo Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['recipient', 'message'], 'properties': {'message': {'type': 'string', 'maxLength': 459, 'minLength': 1, 'description': 'SMS message body.'}, 'recipient': {'type': 'string', 'description': 'Recipient number, for example +27821234567.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['ok', 'status', 'data'], 'properties': {'ok': {'type': 'boolean', 'description': 'Whether the proxied SIMcloud API request returned a 2xx response.'}, 'data': {'oneOf': [{'type': 'object'}, {'type': 'array'}], 'description': 'Decoded SIMcloud API response body.'}, 'status': {'type': 'integer', 'minimum': 0, 'description': 'HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received.'}}, 'additionalProperties': False}
Modificado
create_electricity_order
1 de October de 2026 a las 02:52
Añadido
get_electricity_order
17 de September de 2026 a las 12:55
Añadido
check_electricity_meter
17 de September de 2026 a las 12:55
Añadido
create_electricity_order
17 de September de 2026 a las 12:55
Añadido
get_vas_order
17 de September de 2026 a las 12:55
Añadido
create_vas_order
17 de September de 2026 a las 12:55
Añadido
list_vas_products
17 de September de 2026 a las 12:55
Añadido
get_data_order
17 de September de 2026 a las 12:55
Añadido
list_data_products
17 de September de 2026 a las 12:55
Añadido
create_data_order
17 de September de 2026 a las 12:55
Añadido
get_airtime_order
17 de September de 2026 a las 12:55
Añadido
create_airtime_order
17 de September de 2026 a las 12:55
Añadido
get_sms_status
17 de September de 2026 a las 12:55
Añadido
send_sms
17 de September de 2026 a las 12:55
Añadido
lookup_network
17 de September de 2026 a las 12:55
Añadido
get_transaction_history
17 de September de 2026 a las 12:55
Añadido
get_wallet_balance
17 de September de 2026 a las 12:55
Añadido
register_simcloud_user
17 de September de 2026 a las 12:55