MCP tools

Use catalog tools to resolve ids. Never invent serviceId or countryId.

Ids in replies appear in [brackets]: serviceId (slug), countryId/rentalId (numeric), Order/Receipt ID (tzid). Bulk tools accept 1–20 ids, or omit / [] for all active.

Catalog & balance

Tool	Description
`get_account_balance`	Account balance before spending.
`search_sms_services`	Search Quick SMS services → serviceId.
`get_sms_service_countries`	Countries, price, and stock for a service → countryId.
`find_cheapest_sms_countries`	Cheapest countries by price for a service.

Quick SMS

Tool	Description
`order_sms_verification`spends	Buy a number for verification (spends balance).
`wait_sms_verification`	Wait for the SMS code (prefer this over tight polling).
`check_sms_verification`	Poll inbox for one or more order ids.
`cancel_sms_verification`	Close Quick SMS order(s).
`list_sms_orders`	List active Quick SMS orders (and rentals) after crashes.

Long-term rental

Do not mix Quick SMS tools with long-term rental tools in one flow.

Tool	Description
`list_sms_rentals`	Catalog of long-term rental offers.
`rent_sms_number`spends	Rent a number (spends balance).
`get_sms_rental_messages`	Read rental inbox messages.
`extend_sms_rental`spends	Extend a rental (spends balance).
`cancel_sms_rental`	Cancel rental(s).