For Agents

Tools for humans, callable by agents.

SimonOS exposes the same tool definitions behind the UI as a JSON manifest and API. Agents can discover schemas, inspect examples, and execute universal tools without scraping pages.

Open Manifest View Examples

Discover

Fetch `/tools.json` to see tool IDs, schemas, examples, and execution environments.

Execute

Send {"input": ...} to POST /api/tools/:id for universal tools.

Trust

API behavior is tested against the same shared executors used by the tool registry.

Manifest

Start with the agent-readable catalog.

`/tools.json`

Discover tools

curl https://your-domain.com/tools.json

Examples

Execute universal tools with JSON.

Length Converter

                curl -X POST https://your-domain.com/api/tools/length-converter \
  -H 'content-type: application/json' \
  --data '{"input":{"value":1,"fromUnitId":"m","toUnitId":"ft"}}'

Text Case Converter

                curl -X POST https://your-domain.com/api/tools/text-case-converter \
  -H 'content-type: application/json' \
  --data '{"input":{"text":"SimonOS makes small tools feel fast","transformId":"slug"}}'

Timezone Converter

                curl -X POST https://your-domain.com/api/tools/timezone-converter \
  -H 'content-type: application/json' \
  --data '{"input":{"dateTime":"2026-04-23T14:05","sourceTimeZone":"Europe/Vienna","targetTimeZone":"America/Los_Angeles"}}'

Coverage

Current tool API status.

Tool Category Status

Timestamp Converter

Parse Unix seconds, Unix milliseconds, ISO strings, or readable date strings into common timestamp formats.

Time & Date API ready

Timezone Converter

Convert a local date and time from one IANA timezone to another and return common comparison previews.

Time & Date API ready

Length Converter

Convert a numeric length between supported metric, imperial, and nautical units.

Converters API ready

Base64 Converter

Encode plain UTF-8 text to Base64 or decode UTF-8 Base64 text.

Converters API ready

URL Encoder / Decoder

Encode plain text for URL components or decode percent-escaped URL text back into readable UTF-8.

Converters API ready

Text Case Converter

Generate common prose, URL, and code identifier case variants from text.

Text & Code API ready

JSON Formatter

Validate JSON and return formatted, minified, and optionally key-sorted output.

Text & Code API ready

JWT Decoder

Decode a JWT header and payload into formatted JSON and summarize common registered claims. Signatures are not verified.

Text & Code API ready

Hash Generator

Generate SHA digests from text in the browser using Web Crypto. The JSON API currently exposes schema metadata only.

Text & Code Browser file

Regex Tester

Run a JavaScript regular expression against text and return match indexes, captures, named groups, and truncation status.

Text & Code API ready

Color Converter

Parse a HEX, RGB, or HSL CSS color value and return normalized HEX, RGB, HSL, luminance, and contrast text guidance.

Converters API ready

Word Counter

Count text words, characters, unique words, sentences, paragraphs, lines, and estimated reading time.

Text & Code API ready

Lorem Ipsum Generator

Generate deterministic lorem ipsum placeholder paragraphs with adjustable counts.

Text & Code API ready

Password Generator

Generate a random or seeded password with selected character sets and entropy metadata.

Text & Code API ready

Number Base Converter

Convert an integer between bases 2 through 36.

Converters API ready

URL Parser

Parse an absolute or relative URL into protocol, origin, host, path, query parameters, and fragment.

Text & Code API ready

HTML Entity Converter

Encode HTML-sensitive characters or decode common HTML entities.

Converters API ready

CSV to JSON Converter

Convert CSV text into formatted JSON rows with optional headers.

Converters API ready

Date Difference Calculator

Calculate total days, hours, and calendar parts between two YYYY-MM-DD dates.

Time & Date API ready

List Sorter

Sort pasted lines with optional duplicate removal and numeric sorting.

Text & Code API ready

Text Diff Checker

Compare two text blocks line by line and return additions, removals, unchanged lines, and a unified summary.

Text & Code API ready

UUID Generator

Generate one or more random UUID v4 identifiers.

Text & Code API ready

Image Resizer

Validate browser image resize settings and describe the output file metadata. Binary resizing runs in the browser UI until an API worker is added.

Image Browser file

Image Compressor

Validate browser image compression settings and describe the output image metadata. Binary compression runs in the browser UI.

Image Browser file

Image Cropper

Validate browser image crop coordinates and describe the cropped output dimensions.

Image Browser file

JPG to PNG Converter

Validate JPG to PNG browser conversion settings and describe the output PNG metadata.

Image Browser file

PNG to JPG Converter

Validate PNG to JPG browser conversion settings and describe the output JPG metadata.

Image Browser file

Image Rotator

Validate browser image rotation settings and describe rotated output dimensions.

Image Browser file

Image Flipper

Validate browser image flip settings and describe the mirrored output metadata.

Image Browser file

Watermark Adder for Images

Validate browser image watermark text settings and describe the output image metadata.

Image Browser file

Image Sharpener

Validate browser image sharpening settings and describe the sharpened output metadata.

Image Browser file

Image Blurrer

Validate browser image blur settings and describe the blurred output metadata.

Image Browser file

Image Color Inverter

Validate browser image color inversion settings and describe the inverted output metadata.

Image Browser file

PDF Merger

Validate PDF merge order and output file metadata. Binary PDF merging runs locally in the browser UI.

PDF Tools Browser file

PDF Compressor

Validate PDF compression source metadata. Binary PDF optimization runs locally in the browser UI and reports actual byte savings.

PDF Tools Browser file

PDF Splitter

Validate PDF split settings and output filenames. Binary PDF splitting runs locally in the browser UI.

PDF Tools Browser file

PDF Page Extractor

Validate PDF page extraction settings. Binary page extraction runs locally in the browser UI.

PDF Tools Browser file

PDF Page Deleter

Validate PDF page deletion settings. Binary page deletion runs locally in the browser UI.

PDF Tools Browser file

PDF Rotator

Validate PDF page rotation settings. Binary page rotation runs locally in the browser UI.

PDF Tools Browser file

PDF Page Reorder

Validate PDF page reorder settings. Binary page reordering runs locally in the browser UI.

PDF Tools Browser file

JPG to PDF Converter

Validate JPG to PDF settings and output metadata. Binary image embedding runs locally in the browser UI.

PDF Tools Browser file

PNG to PDF Converter

Validate PNG to PDF settings and output metadata. Binary image embedding runs locally in the browser UI.

PDF Tools Browser file

Image Batch to PDF

Validate mixed image batch to PDF settings and output metadata. Binary image embedding runs locally in the browser UI.

PDF Tools Browser file

Add Watermark to PDF

Validate text watermark settings for a PDF. Binary watermarking runs locally in the browser UI.

PDF Tools Browser file

PDF Editor (Text Add)

Validate short text stamping settings for selected PDF pages. Binary editing runs locally in the browser UI.

PDF Tools Browser file

PDF Cropper

Validate PDF crop margins and page ranges. Binary crop-box editing runs locally in the browser UI.

PDF Tools Browser file

PDF Page Number Adder

Validate PDF page numbering settings. Binary page numbering runs locally in the browser UI.

PDF Tools Browser file

CSV to PDF Converter

Validate CSV to PDF table settings and output metadata. Binary PDF table generation runs locally in the browser UI.

PDF Tools Browser file

PDF Signature Adder

Validate visible typed signature placement for selected PDF pages. This is not cryptographic signing.

PDF Tools Browser file

PDF Form Filler

Validate PDF form-fill metadata. Binary field inspection and filling run locally in the browser UI.

PDF Tools Browser file

PDF Annotation Adder

Validate visible PDF annotation text placement for selected pages. Binary text drawing runs locally in the browser UI.

PDF Tools Browser file

PDF Header/Footer Adder

Validate PDF header/footer text settings. Binary text drawing runs locally in the browser UI.

PDF Tools Browser file

PDF Page Size Changer

Validate PDF page-size settings. Binary page resizing runs locally in the browser UI.

PDF Tools Browser file

PDF Bates Numbering

Validate PDF Bates numbering settings. Binary numbering runs locally in the browser UI.

PDF Tools Browser file

PDF Metadata Editor

Validate PDF metadata fields. Binary metadata editing runs locally in the browser UI.

PDF Tools Browser file

Markdown to PDF

Validate markdown PDF export settings and return preview metadata. Binary PDF generation runs locally in the browser UI.

Document Tools Browser file

Document OCR

Validate image OCR source metadata. Text extraction runs locally in the browser UI with an OCR worker.

Document Tools Browser file

Response shape

Successful requests return a stable envelope. Invalid inputs return `ok: false` with a machine-readable error code.

{
  "ok": true,
  "toolId": "length-converter",
  "output": {
    "value": 3.280839895013123,
    "formattedValue": "3.28084"
  }
}