SIMcloud

za.co.simcloudPublished by simcloud.co.zaOfficial publisherv0.2.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Remote South African MCP server that lets an assistant buy airtime, data, SMS, VAS vouchers and prepaid electricity, and check wallet balance and orders.

What you can do
Create and manage child SIMcloud accounts, including issuing their API tokens and confirming consent details first. Check the authenticated account wallet balance and read transaction history across airtime, data, SMS, VAS and electricity activity. Look up the South African mobile network for a number before sending. Send SMS and fetch delivery status by message ID. List data bundle and VAS voucher products, then create airtime, data and VAS orders and fetch their status. Check prepaid electricity meters, buy electricity, and retrieve electricity orders.
When to use it
Useful when an assistant needs to handle South African prepaid telecom and utility purchases on a SIMcloud account: topping up airtime or data, sending SMS, buying vouchers or electricity, and reviewing balance and order history.
Requirements
A remote streamable HTTP endpoint at simcloud.co.za; no local runtime or package is needed. An authenticated SIMcloud account with wallet funds for purchases; child accounts receive their own API token. Network access to the endpoint.
Before you install
Order and SMS tools spend wallet funds and are irreversible external actions; confirm recipient, amount and reference first and do not auto-retry ambiguous results. register_simcloud_user creates accounts and returns a child account API token that must be stored securely. Network lookups are recorded in account history.

Installation

In SourceWeft

  1. Open SIMcloud in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/za.co.simcloud%2Fsimcloud/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "simcloud": {
      "type": "http",
      "url": "https://simcloud.co.za/api/mcp.php"
    }
  }
}

README

This repository has no README.

Tools

17

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.

Parameterscellrequiredemailrequiredvatnoaddresspasswordrequiredid_numberlast_namerequiredfirst_namerequiredbusiness_regbusiness_name

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.

Takes no parameters.

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.

Parameterstypelimitcursordate_torequireddate_fromrequired

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.

Parametersmsisdnrequired

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.

Parametersmessagerequiredrecipientrequired

get_sms_status

Get SMS status

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

Parameterssms_idrequired

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.

Parametersamountrequiredmsisdnrequirednetworkrequiredreferencerequired

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.

Parametersordernorequest_id

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.

Parametersamountrequiredmsisdnrequirednetworkrequiredreferencerequired

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.

Parametersnetwork

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.

Parametersordernorequest_id

list_vas_products

List VAS products

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

Takes no parameters.

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.

Parametersamountrequiredreferencerequiredproduct_idvoucher_type

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.

Parametersorder_idtransaction_id

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.

Parametersamountrequiredrecipientrequiredmeter_numberrequiredclient_referencerequired

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.

Parametersmeter_numberrequired

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.

Parametersorder_idclient_referenceorder_reference_id

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.