{"id":"roman-numeral-convert","version":"1.0.0","description":"Convert integers 1–3999 to canonical Roman numerals and strictly parse canonical numerals back to integers.","supported_operations":["convert integer to canonical roman numeral","strictly parse a roman numeral","roman numeral conversion both directions","format a number using roman numerals","decode canonical subtractive roman notation","validate and convert roman numeral text","turn a roman numeral into an integer"],"unsupported_operations":["historical additive or non-canonical notation","numbers below 1 or above 3999","Unicode Roman numeral code points","fractions or vinculum notation"],"semantics":["operation format requires value and forbids numeral; operation parse requires numeral and forbids value.","Formatting uses the unique conventional modern form and only the subtractive pairs IV, IX, XL, XC, CD, and CM.","Parsing accepts only uppercase ASCII canonical standard form; no whitespace trimming, case folding, or Unicode numeral normalization occurs.","Both operations return the exact canonical pair {value, numeral}; no approximation, rounding, or tie-breaking occurs.","At most 15 UTF-8 numeral bytes are accepted, and values are bounded to integers from 1 through 3999."],"limits":{"max_numeral_bytes":15,"max_value":3999},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"type":"string","enum":["format","parse"]},"value":{"type":"integer","minimum":1,"maximum":3999},"numeral":{"type":"string","minLength":1,"maxLength":15,"pattern":"^[IVXLCDM]+$"}}},"output_schema":{"type":"object","additionalProperties":false,"required":["value","numeral"],"properties":{"value":{"type":"integer","minimum":1,"maximum":3999},"numeral":{"type":"string","minLength":1,"maxLength":15,"pattern":"^[IVXLCDM]+$"}}},"examples":[{"input":{"operation":"format","value":1994},"output":{"value":1994,"numeral":"MCMXCIV"}},{"input":{"operation":"parse","numeral":"XLII"},"output":{"value":42,"numeral":"XLII"}}],"execute_url":"/v1/tools/roman-numeral-convert/versions/1.0.0/execute"}