# Roman Numeral Converter

> Roman Numeral Converter is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Bidirectionally converts integers (1–3999) to Roman numerals and Roman numerals back to integers, with strict validation that rejects non-standard forms.

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/converters/roman-numeral-converter?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/roman-numeral-converter-74131c90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x0aQeWytJFh38uP7WyOqh

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 roman-numeral-converter-74131c90
```

Example prompt: Convert 2024 to Roman numerals using the to_roman operation — I need the properly formatted numeral string.

## When to prefer this

Use this endpoint when you need a strict, standards-compliant bidirectional conversion between integers and Roman numerals, particularly when you need validation that rejects malformed numerals. Ideal for formatting chapter numbers, years, or legal document numbering in Roman numeral style, or for parsing Roman numerals found in text.

## Known failure modes

- Input integer out of range (must be 1–3999) returns an error
- Non-standard Roman numeral forms (e.g. IIIM, VX) are rejected as invalid
- Missing required 'value' query parameter causes a validation error
- Invalid 'op' enum value (anything other than to_roman or from_roman) returns an error
- Non-numeric string passed to to_roman direction fails validation

## How this service works

Convert numbers to Roman numerals (1–3999) and Roman numerals back to numbers, with strict validation that rejects non-standard forms like IIIM or VX. Use this when an agent needs to numbers ↔ Roman numerals, with validation.

## Output

Returns either the Roman numeral string (for to_roman) or the integer value (for from_roman), along with validation. Non-standard forms like IIIM or VX are rejected with an error indicating the input is invalid.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "value"
     ],
     "properties": {
      "op": {
       "enum": [
        "to_roman",
        "from_roman"
       ],
       "type": "string",
       "description": "Direction"
      },
      "value": {
       "type": "string",
       "description": "Number or numeral"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/roman-numeral-converter-74131c90/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)