text_numbers
utilpeek: Convert numbers to English words. For units use convert_units. Returns a number spelled out in English (cardinal, ordinal, year, or currency for 13 currencies, rounded half-even to the minor unit; INR in lakh and crore by default) up to 10^36, or English number words ("two hundred and fifty-first") parsed back to a number. value is a decimal string or an integer, never a float. Invalid or out-of-range input is a 422 (not charged). Typically under 0.3 s. Price: USD 0.001. Free: 10 utilpeek calls per IP per UTC day.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "text_numbers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | to_words (default: `value` to English words) or to_number (`text` to a number). | to_words |
| only | No | style=currency: end with "only" (default false). | |
| text | No | to_number: English number words. | |
| style | No | to_words style: cardinal (default), ordinal, currency or year (an integer 1-9999). | cardinal |
| value | No | to_words: a decimal string or an integer (no floats: no rounding surprises). | |
| currency | No | style=currency: AUD, BRL, CAD, CHF, CNY, EUR, GBP, INR, JPY, MXN, PHP, SGD or USD (default). | USD |
| lakh_crore | No | style=currency: Indian lakh and crore words (default: INR only). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | ||
| error | No | Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object. | |
| style | No | ||
| value | No | ||
| words | No | ||
| number | No | ||
| source | No | ||
| currency | No | ||
| rounded_to | No |