# Roman numeral converter

Convert a number to Roman numerals or Roman numerals to a number, from 1 to 3,999,999.

- Endpoint: `POST https://setget.net/v1/tools/roman-numerals` with JSON `{"input": {...}}`
- MCP: `run_tool` with `slug` = `roman-numerals`
- Page: https://setget.net/tools/roman-numerals

## Inputs

- `value` (required, string): A whole number, or a Roman numeral.

## Example 1

```json
{"input":{"value":"2026"}}
```

Result:

```json
{"direction":"to_roman","number":2026,"roman":"MMXXVI","overline":"MMXXVI"}
```

## Example 2: Roman to number

```json
{"input":{"value":"MCMXCIV"}}
```

Result:

```json
{"direction":"to_number","number":1994,"roman":"MCMXCIV","overline":"MCMXCIV"}
```

## Example 3: Above 3,999

```json
{"input":{"value":"12345"}}
```

Result:

```json
{"direction":"to_roman","number":12345,"roman":"(XII)CCCXLV","overline":"X̅I̅I̅CCCXLV"}
```

**How are numbers above 3,999 written?** With a line over a numeral, which multiplies it by 1,000. "roman" shows the overlined part in brackets, so (XII)CCCXLV is 12,345, and "overline" uses real overline marks, which not every font can display.

**Why is IIII rejected?** Only the standard form is accepted, and the standard form of 4 is IV. The error tells you the standard spelling of the number you wrote.

**Is there a Roman numeral for zero?** No. The system starts at I (1).
