Buy US numbers (wallet)
buy_numbersOrder new US phone numbers on your MeiSIM account, paid from its prepaid wallet. Prepaid: no returns, no refunds once a number is delivered. Choose billing "daily" (a minimum number of days paid now, then each day from the wallet) or "monthly" (a minimum number of months paid up front). A monthly order also says line_history: "fresh" or "any"; ask the user which. Call get_number_pricing first and tell the user the total. Numbers usually land within about 15 minutes; check with get_order. Safe to retry with the same customer_reference. Needs your API key.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"count": "<count>",
"billing": "<billing>"
},
"name": "buy_numbers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Daily billing only: days to pay now (at least the minimum). | |
| count | Yes | How many numbers. | |
| voice | No | Also calls over SIP (costs more; must be enabled on the account). | |
| months | No | Monthly billing only: months to pay up front (at least the minimum). | |
| billing | Yes | "daily" or "monthly". See get_number_pricing. | |
| zip_code | No | 5-digit US ZIP to pick the number's area, if available. | |
| area_code | No | Preferred 3-digit US area code, if available. | |
| line_history | No | Monthly billing: "fresh" for a number no other account has held (no refund if the carrier blocks it), or "any" for a number from stock that may have been used before. Required for monthly orders. | |
| customer_reference | No | Your own reference for this order; a repeat with the same reference returns the first order. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| voice | Yes | ||
| status | Yes | ||
| billing | Yes | ||
| numbers | Yes | ||
| ordered | Yes | ||
| order_id | Yes | ||
| days_paid | Yes | ||
| delivered | Yes | ||
| duplicate | Yes | ||
| created_at | Yes | ||
| charged_usd | Yes | ||
| outstanding | Yes | ||
| completed_at | Yes | ||
| refunded_usd | Yes | ||
| customer_reference | Yes |