SIMcloud

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

使うべきか

品質と安全性

A
説明の品質
98%
スキーマの完全性
84%
命名の品質
98%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~4,641トークン数(ツール定義)
~2.4 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 3.63%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

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

リモートエンドポイント

https://simcloud.co.za/api/mcp.phpstreamable-http

できること

ツール一覧

ツール(17)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🔴register_simcloud_user(first_name, last_name, cell, email, password, ...)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "minLength": 1
    },
    "last_name": {
      "type": "string",
      "minLength": 1
    },
    "cell": {
      "type": "string",
      "pattern": "^0[0-9]{9}$",
      "description": "10-digit South African mobile number beginning with 0."
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "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."
    },
    "business_name": {
      "type": "string"
    },
    "business_reg": {
      "type": "string"
    },
    "vatno": {
      "type": "string"
    },
    "address": {
      "type": "string"
    }
  },
  "required": [
    "first_name",
    "last_name",
    "cell",
    "email",
    "password"
  ],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢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.

入力スキーマ

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢get_transaction_history(date_from, date_to, type, limit, cursor)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "date_from": {
      "type": "string",
      "format": "date",
      "description": "Inclusive start date in YYYY-MM-DD format, interpreted in Africa/Johannesburg time."
    },
    "date_to": {
      "type": "string",
      "format": "date",
      "description": "Inclusive end date in YYYY-MM-DD format. The maximum range is 90 days."
    },
    "type": {
      "type": "string",
      "description": "Optional comma-separated service filter: airtime, data, electricity, vas and sms."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 50
    },
    "cursor": {
      "type": "string",
      "description": "Opaque cursor returned by the previous result. Keep the same date range and type filter."
    }
  },
  "required": [
    "date_from",
    "date_to"
  ],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
⚪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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "msisdn": {
      "type": "string",
      "description": "South African mobile number, for example 0821234567."
    }
  },
  "required": [
    "msisdn"
  ],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🔴send_sms(recipient, message)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "recipient": {
      "type": "string",
      "description": "Recipient number, for example +27821234567."
    },
    "message": {
      "type": "string",
      "description": "SMS message body.",
      "minLength": 1,
      "maxLength": 459
    }
  },
  "required": [
    "recipient",
    "message"
  ],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢get_sms_status(sms_id)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "sms_id": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "sms_id"
  ],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🔴create_airtime_order(msisdn, network, amount, 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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "msisdn": {
      "type": "string",
      "description": "South African mobile number to recharge, for example 0821234567 or +27821234567."
    },
    "network": {
      "type": "string",
      "enum": [
        "mtn",
        "p-mtn",
        "vodacom",
        "p-vodacom",
        "cellc",
        "cell-c",
        "cell c",
        "p-cellc",
        "telkom",
        "heita",
        "p-heita"
      ],
      "description": "Supported South African airtime network name or SIMcloud internal code."
    },
    "amount": {
      "type": "number",
      "minimum": 2,
      "maximum": 999,
      "description": "Airtime amount in South African rand, from R2 to R999."
    },
    "reference": {
      "type": "string",
      "minLength": 1,
      "description": "User or system reference for this airtime order."
    }
  },
  "required": [
    "msisdn",
    "network",
    "amount",
    "reference"
  ],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢get_airtime_order(request_id, orderno)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "integer",
      "minimum": 1,
      "description": "SIMcloud request identifier returned when the order was queued."
    },
    "orderno": {
      "type": "string",
      "description": "SIMcloud platform order number returned during processing."
    }
  },
  "required": [],
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "request_id"
      ]
    },
    {
      "required": [
        "orderno"
      ]
    }
  ]
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🔴create_data_order(msisdn, network, amount, 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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "msisdn": {
      "type": "string",
      "description": "South African mobile number to recharge, for example 0821234567 or +27821234567."
    },
    "network": {
      "type": "string",
      "enum": [
        "mtn",
        "pd-mtn",
        "vodacom",
        "pd-vodacom",
        "cellc",
        "cell-c",
        "cell c",
        "pd-cellc",
        "telkom",
        "heita",
        "pd-heita"
      ],
      "description": "Supported South African data network name or SIMcloud internal code returned by list_data_products."
    },
    "amount": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Exact data bundle sell value returned by list_data_products."
    },
    "reference": {
      "type": "string",
      "minLength": 1,
      "description": "User or system reference for this data order."
    }
  },
  "required": [
    "msisdn",
    "network",
    "amount",
    "reference"
  ],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "description": "Optional friendly network name or internal code, for example mtn or pd-mtn."
    }
  },
  "required": [],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢get_data_order(request_id, orderno)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "integer",
      "minimum": 1,
      "description": "SIMcloud request identifier returned when the order was queued."
    },
    "orderno": {
      "type": "string",
      "description": "SIMcloud platform order number returned during processing."
    }
  },
  "required": [],
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "request_id"
      ]
    },
    {
      "required": [
        "orderno"
      ]
    }
  ]
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢list_vas_products

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

入力スキーマ

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🔴create_vas_order(product_id, voucher_type, amount, reference)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "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."
    },
    "amount": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "reference": {
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "amount",
    "reference"
  ],
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "product_id"
      ]
    },
    {
      "required": [
        "voucher_type"
      ]
    }
  ]
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "minimum": 1
    },
    "transaction_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [],
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "order_id"
      ]
    },
    {
      "required": [
        "transaction_id"
      ]
    }
  ]
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🔴create_electricity_order(meter_number, amount, client_reference, recipient)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "meter_number": {
      "type": "string",
      "maxLength": 50,
      "description": "Prepaid electricity meter number previously checked with check_electricity_meter."
    },
    "amount": {
      "type": "integer",
      "minimum": 55,
      "maximum": 1000,
      "description": "Electricity purchase amount in whole South African rand (no cents), from R55 to R1000."
    },
    "client_reference": {
      "type": "string",
      "description": "User or system reference for this electricity order."
    },
    "recipient": {
      "type": "string",
      "description": "Recipient mobile number for voucher notifications."
    }
  },
  "required": [
    "meter_number",
    "amount",
    "client_reference",
    "recipient"
  ],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "meter_number": {
      "type": "string",
      "description": "Prepaid electricity meter number to validate."
    }
  },
  "required": [
    "meter_number"
  ],
  "additionalProperties": false
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}
🟢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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "minimum": 1
    },
    "client_reference": {
      "type": "string"
    },
    "order_reference_id": {
      "type": "string"
    }
  },
  "required": [],
  "additionalProperties": false,
  "anyOf": [
    {
      "required": [
        "order_id"
      ]
    },
    {
      "required": [
        "client_reference"
      ]
    },
    {
      "required": [
        "order_reference_id"
      ]
    }
  ]
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether the proxied SIMcloud API request returned a 2xx response."
    },
    "status": {
      "type": "integer",
      "minimum": 0,
      "description": "HTTP status returned by the SIMcloud API, or 0 when no HTTP response was received."
    },
    "data": {
      "oneOf": [
        {
          "type": "object"
        },
        {
          "type": "array"
        }
      ],
      "description": "Decoded SIMcloud API response body."
    }
  },
  "required": [
    "ok",
    "status",
    "data"
  ],
  "additionalProperties": false
}

推奨プロンプト

retrieve_data
Get details about [item] from SIMcloud
想定されるツール: get_wallet_balance
fetch_info
Fetch [information type] using SIMcloud
想定されるツール: get_wallet_balance
list_items
List all [items] available in SIMcloud
想定されるツール: list_data_products
browse_collection
Show me the [collection] from SIMcloud
想定されるツール: list_data_products
explore_workflow
List available [items], then get details for each one using SIMcloud
想定されるツール: list_data_productsget_wallet_balance

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 17 件
観測失敗バージョンは記録されていません—
観測失敗バージョンは記録されていません—
観測失敗バージョンは記録されていません—
観測失敗バージョンは記録されていません—