Formatting Utilities

Number To Roman

Converts integers to Roman numeral format with proper formatting rules. Access via MCP in Cursor or Windsurf, or call GET /v1/format/roman with a number parameter. Returns "MCMXC" for 1990, handles 1-3999 range. Perfect for generating document section numbers, historical dates, or UI formatting where Roman numerals add classical styling.

API Endpoint

GET /v1/format/roman

Code Examples

curl "https://tinyfn.io/v1/format/roman" \
  -H "X-API-Key: YOUR_API_KEY"
const response = await fetch('https://tinyfn.io/v1/format/roman', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get('https://tinyfn.io/v1/format/roman',
    headers={'X-API-Key': 'YOUR_API_KEY'})
data = response.json()
print(data)

Use via MCP

Add to your AI agent

Connect your AI agent (Claude, Cursor, Windsurf, etc.) to TinyFn's formatting tools:

{
  "mcpServers": {
    "tinyfn-format": {
      "url": "https://tinyfn.io/mcp/format",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Learn more about MCP setup →

Related Tools

Format Number
Format a number with locale-specific separators.
Format Currency
Format an amount as currency.
Format Percentage
Format a number as a percentage.
Format Ordinal
Convert a number to its ordinal form (1st, 2nd, 3rd, etc.).
Number To Words
Convert a number to words.
Roman To Number
Convert Roman numerals to a number.
Format Bytes
Format bytes to human-readable size.
Format Phone
Format a phone number according to country conventions.

FAQ

What number range does the Roman numeral converter support?

Supports integers from 1 to 3999. Numbers outside this range aren't supported since traditional Roman numerals don't have standard representations for zero, negatives, or numbers above 3999.

How do I convert numbers to Roman numerals using MCP in Cursor?

Call the number_to_roman tool with your integer. The MCP tool handles the conversion automatically and returns properly formatted Roman numerals following traditional rules.

Does the converter use subtractive notation like IV for 4?

Yes, it uses standard subtractive notation. 4 becomes IV, 9 becomes IX, 40 becomes XL, 90 becomes XC, 400 becomes CD, and 900 becomes CM.

Can I batch convert multiple numbers to Roman numerals?

The tool converts one number per call. For batch operations, make multiple API calls or use the MCP tool iteratively in your AI coding assistant.

What format does the Roman numeral output use?

Returns uppercase Roman numerals as a plain string. For example: 2024 returns "MMXXIV", 500 returns "D", 1776 returns "MDCCLXXVI".

Try Number To Roman Now

Get your free API key and start using Number To Roman in seconds.

Get Free API Key