mcp server

SIMcloud

South African MCP server for airtime, data, SMS, VAS, electricity, balance, and network lookup.

Description as published by the maintainer. Source

• version 0.2.0
• active

active — Registry entry last updated 2026-07-16.

What this server can do

16 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

check_electricity_meter(meter_number)

Use this before create_electricity_order to check whether a prepaid electricity meter is supported. This does not buy electricity or spend wallet funds. Required: meter_number.

create_airtime_order(amount, msisdn, network, reference)

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. Required: msisdn, network, amount, reference.

create_data_order(amount, msisdn, network, reference)

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. Required: msisdn, network, amount, reference.

create_electricity_order(amount, recipient, meter_number, client_reference)

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. Required: meter_number, amount, client_reference, recipient.

create_vas_order(amount, reference, product_id, voucher_type)

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. Required: amount, reference.

get_airtime_order(orderno, request_id)

Use this after create_airtime_order, or after an ambiguous create result, to fetch the authenticated account airtime order by request_id or orderno.

get_data_order(orderno, request_id)

Use this after create_data_order, or after an ambiguous create result, to fetch the authenticated account data order by request_id or orderno.

get_electricity_order(order_id, client_reference, order_reference_id)

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.

get_sms_status(sms_id)

Use this after send_sms to fetch the delivery status of an authenticated account SMS by sms_id. Required: sms_id.

get_transaction_history(type, limit, cursor, date_to, date_from)

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. Required: date_from, date_to.

get_vas_order(order_id, transaction_id)

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.

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.

list_data_products(network)

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.

list_vas_products

Use this before create_vas_order to list active SIMcloud VAS voucher products and their available denominations.

lookup_network(msisdn)

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. Required: msisdn.

send_sms(message, recipient)

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. Required: recipient, message.

Last successful function declaration observed on 2026-08-13. Source: https://simcloud.co.za/api/mcp.php. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://simcloud.co.za/api/mcp.php.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/ErikThiart/simcloud
• Website — https://simcloud.co.za/api/ai.html
• Remote endpoint (streamable-http) — https://simcloud.co.za/api/mcp.php