{"uid":"cap_x0aQeWytJFh38uP7WyOqh","slug":"roman-numeral-converter-74131c90","name":"Roman Numeral Converter","description":"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.","url":"https://agentstoolshub.com/api/v1/converters/roman-numeral-converter?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YVbWa__w8873I2IjT1Ev2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Bidirectionally converts integers (1–3999) to Roman numerals and Roman numerals back to integers, with strict validation that rejects non-standard forms.","exampleAgentPrompt":"Convert 2024 to Roman numerals using the to_roman operation — I need the properly formatted numeral string.","exampleUseCases":[{"title":"Year as Roman numeral for document","prompt":"What is 1999 in Roman numerals? I want to use it as a chapter date in my document."},{"title":"Decode Roman numeral from inscription","prompt":"What number does the Roman numeral MCMXCIX represent? Convert it back to a regular integer for me."},{"title":"Validate Roman numeral correctness","prompt":"Is IIIM a valid Roman numeral, or is it non-standard? Run it through the from_roman converter and tell me what you get."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:39:29.429Z","isFirstParty":false,"canonicalSlug":"roman-numeral-converter-74131c90"}