# Tanod utilpeek Number Words

> Tanod utilpeek Number Words is a paid API for AI agents from tanod.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Converts numbers to English words (cardinal, ordinal, currency, year styles) and parses English number words back to numeric values.

## Facts

- Endpoint: POST https://tanod.dev/v1/text/numbers?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-utilpeek-number-words-6dd3c3e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G6aQK6k6WRLdgwdytOu2F

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanod-utilpeek-number-words-6dd3c3e0 -d '<json body>'
```

Example prompt: Spell out the number 4250 in words as a currency amount in USD — I need it written out like you'd see on a check.

## When to prefer this

Choose this endpoint when you need reliable, formatted English word representations of numbers (cardinal, ordinal, currency written-out, or year format) or when parsing English number-word strings back to numeric values. It handles edge cases like currency formatting across 13 currencies and avoids float rounding surprises by accepting decimal strings. Prefer it over general LLM text generation for number-to-words tasks where consistency and correctness matter, such as legal documents, invoices, or check amounts.

## Known failure modes

- Invalid or missing 'value' when mode is 'to_words' returns an error
- Invalid or missing 'text' when mode is 'to_number' returns an error
- Float values not accepted; must use decimal string or integer to avoid rounding issues
- Text exceeding 500 characters or value string exceeding 60 characters rejected
- Unrecognized English number words may fail to parse
- Unsupported currency code returns validation error

## How this service works

One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.

## Output

Returns the converted result: either a string of English words representing the input number (in the requested style — cardinal, ordinal, currency, or year) or a numeric value parsed from the input English number words. The response reflects the chosen mode and style, with currency output formatted appropriately for the selected currency code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "to_words",
    "to_number"
   ],
   "type": "string",
   "default": "to_words",
   "description": "to_words (default: `value` to English words) or to_number (`text` to a number)."
  },
  "text": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 500,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "to_number: English number words."
  },
  "style": {
   "enum": [
    "cardinal",
    "ordinal",
    "currency",
    "year"
   ],
   "type": "string",
   "default": "cardinal",
   "description": "to_words style: cardinal (default), ordinal, currency or year (an integer 1-9999)."
  },
  "value": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 60,
     "minLength": 1
    },
    {
     "type": "integer"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "to_words: a decimal string or an integer (no floats: no rounding surprises)."
  },
  "currency": {
   "enum": [
    "AUD",
    "BRL",
    "CAD",
    "CHF",
    "CNY",
    "EUR",
    "GBP",
    "INR",
    "JPY",
    "MXN",
    "PHP",
    "SGD",
    "USD"
   ],
   "type": "string",
   "default": "USD",
   "description": "style=currency: AUD, BRL, CAD, CHF, CNY, EUR, GBP, INR, JPY, MXN, PHP, SGD or USD (default)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "style": "currency",
  "value": "1234.5",
  "words": "one thousand two hundred thirty-four dollars and fifty cents",
  "source": {
   "library": "own implementation (standard library)",
   "license": "n/a"
  },
  "currency": "USD",
  "rounded_to": "1234.50"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-utilpeek-number-words-6dd3c3e0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)
