Buy US numbers (wallet)
buy_numbersOrder new US phone numbers on your MeiSIM account, paid from its prepaid wallet. Choose daily or monthly billing, set an area code or ZIP, and check pricing before confirming.
Instructions
Order 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 |