create_airtime_order

Queues a prepaid airtime order. Duplicate same-MSISDN-and-amount requests inside 5 minutes may return HTTP 409.

Server SIMcloud https://simcloud.co.za/api/mcp.php
Category Financial
Risk class Critical
Parameters 44 required

What create_airtime_order does on SIMcloud

AI agents use create_airtime_order to commit financial operations through SIMcloud — usually the final step of a payment, billing, or trading workflow. A call moves real money.

ParameterTypeRequiredDescription
amount number Yes
msisdn string Yes
network string Yes Friendly network name or internal code.
reference string Yes

Parameters from the server's own tool schema.

Why create_airtime_order needs a policy

Creating an airtime order constitutes a financial commitment: it charges the user's wallet or account balance to purchase prepaid airtime for a given MSISDN. The mention of duplicate-request protection (HTTP 409) further confirms real monetary transactions are being initiated. Financial is the most severe applicable category.

From the tool's definition 'Queues a prepaid airtime order' — this tool commits a financial transaction by purchasing airtime, which involves spending wallet/account funds.

Questions about create_airtime_order

What does the create_airtime_order tool do? +

Queues a prepaid airtime order. Duplicate same-MSISDN-and-amount requests inside 5 minutes may return HTTP 409. It is categorised as a Financial tool in the SIMcloud MCP Server, which means it involves financial transactions. Block by default and require explicit approval.

What parameters does create_airtime_order accept? +

create_airtime_order accepts 4 parameters: amount, msisdn, network, reference. Required: amount, msisdn, network, reference. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on create_airtime_order? +

Register the SIMcloud MCP server in PolicyLayer and add a rule for create_airtime_order: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches SIMcloud. Nothing to install.

What risk level is create_airtime_order? +

create_airtime_order is a Financial tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.

Can I rate-limit create_airtime_order? +

Yes. Add a rate_limit block to the create_airtime_order rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block create_airtime_order completely? +

Set action: deny in the PolicyLayer policy for create_airtime_order. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides create_airtime_order? +

create_airtime_order is provided by the SIMcloud MCP server (https://simcloud.co.za/api/mcp.php). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// THE FULL RECORD

create_airtime_order is one line of SIMcloud's registry record.

The record carries the whole server: verified identity, auth posture, risk grade, every tool classified, recommended policy — re-checked continuously.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.