conversion_roman_numerals
Convert integers to Roman numerals or parse Roman numerals back to integers, with automatic direction detection and validation of subtractive notation.
Instructions
Roman Numerals Converter. Convert an integer to a Roman numeral or parse a Roman numeral back to an integer, over the standard 1-3999 range (largest value MMMCMXCIX). Set direction to to_roman or to_arabic, or leave it auto to detect from the input (letters I V X L C D M parse as Roman; digits parse as a number). Validates subtractive notation and rejects out-of-range or malformed input with an error. Use conversion_number_base or conversion_base_converter instead for binary/octal/hex radix conversion. Runs locally: read-only, non-destructive, offline, and rate-limited. Returns the converted value plus conversion steps, a character breakdown, historical facts, and alternative representations (binary, octal, hex, words, ordinal).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes | Value to convert: an integer 1-3999 (e.g. 2024) or a Roman numeral (e.g. MCMXCIV). Trimmed; Roman input is case-insensitive. | |
| direction | No | Conversion direction. auto detects from input (letters I V X L C D M to_arabic, digits to_roman); to_roman forces integer-to-Roman; to_arabic forces Roman-to-integer. | auto |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | Whether the conversion succeeded. | |
| error | No | Error message when success is false (e.g. out-of-range or invalid Roman numeral). | |
| result | No | The conversion result (present when success is true). |