AgentTools

Returns the current date and time in any IANA time zone, plus Unix seconds/milliseconds, ISO 8601, weekday and day-of-year. Use it whenever an agent needs to know 'now'. Use this when an agent needs to the current date/time in any time zone — agents have no clock.

Calculate the final sale price and the amount saved for any price and percent-off discount, with the working shown. Use this when an agent needs to sale price and savings from a percent off.

Calculate the tip for any bill, the grand total, and how much each person pays when splitting. Defaults to a 15% tip. Use this when an agent needs to tip amount, total and per-person split.

Calculate Body Mass Index from weight (kg) and height (cm), with the WHO weight category and the healthy BMI weight range for your height. Use this when an agent needs to body Mass Index with WHO category.

Count the total days between two dates, plus the breakdown in weeks and days and in calendar years, months and days. Use this when an agent needs to days, weeks and calendar time between two dates.

Calculate a person's exact age in calendar years, months and days from their date of birth, plus total days lived. Reference date defaults to today (UTC). Use this when an agent needs to exact age in years, months and days.

Calculate the liters of fuel a trip needs and its total cost from distance, consumption (L/100 km) and price per liter — with optional cost splitting between passengers. Use this when an agent needs to trip fuel and cost, splitable between people.

Estimate reading time from a word count at any reading speed. Defaults to 200 words per minute — the typical silent-reading speed for adults. Use this when an agent needs to how long a text takes to read, by word count.

Convert between metric and imperial length units: kilometers, meters, centimeters, millimeters, micrometers, nanometers, miles, yards, feet, inches and nautical miles. Use this when an agent needs to metric and imperial distance units, instantly.

Convert between weight and mass units: metric tons, kilograms, grams, milligrams, pounds, ounces and stones with exact international definitions. Use this when an agent needs to kilograms, pounds, ounces and more.

Convert between Celsius, Fahrenheit and Kelvin with exact formulas, reference points (freezing and boiling water) and step-by-step working. Use this when an agent needs to celsius, Fahrenheit and Kelvin, both ways.

Convert digital storage units: bits, bytes, KB, MB, GB, TB (decimal, ×1000) and KiB, MiB, GiB, TiB (binary, ×1024) — both systems side by side. Use this when an agent needs to decimal (KB/MB/GB) and binary (KiB/MiB/GiB) units.

Convert speed units: kilometers per hour, miles per hour, meters per second, knots and feet per second with exact definitions. Use this when an agent needs to km/h, mph, m/s, knots and ft/s.

Convert area units: square millimeters, centimeters, meters and kilometers, hectares, acres, square feet and square miles. Use this when an agent needs to square meters, feet, acres, hectares.

Convert Unix epoch timestamps to ISO/UTC dates and back. Millisecond timestamps are detected automatically; invalid dates are rejected with clear errors. Use this when an agent needs to epoch seconds ↔ human dates, both directions.

Convert integers between any bases from 2 to 36 — binary, octal, decimal, hexadecimal and beyond — with BigInt precision (no limit on magnitude). Use this when an agent needs to binary, octal, decimal, hex — any base 2–36.

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.

Convert text between nine letter cases: UPPER, lower, Title, Sentence, camelCase, PascalCase, snake_case, kebab-case and CONSTANT_CASE. camelCase boundaries are split automatically. Use this when an agent needs to camelCase, snake_case, kebab-case and more.

Percent-encode text for safe inclusion in URLs and query strings, or decode percent-encoded text back. Uses the standard encodeURIComponent rules. Use this when an agent needs to percent-encoding for query strings and URLs.

Validate JSON with precise error messages, pretty-print it with any indent, and inspect its top-level type and element counts. Use this when an agent needs to validate, pretty-print and inspect JSON.

Reference database of HTTP response status codes with phrase, category and explanation. Look up a specific code or list a whole category (1xx–5xx). Use this when an agent needs to look up any HTTP status code's meaning.

Look up MIME content types by type substring or file extension, or list a category — covering text, application, image, audio, video, font and multipart types used in web APIs. Use this when an agent needs to content-Type lookup by type or file extension.

Convert between wei, kwei, mwei, gwei, microether, milliether and ether with exact BigInt arithmetic. Decimal strings of any magnitude convert without floating-point error. Use this when an agent needs to exact Ethereum unit conversion — no float errors.

Calculate return on investment: profit (or loss) and the percentage return relative to the initial amount invested. Use this when an agent needs to return on investment as a percentage.

Calculate the compound annual growth rate that takes an initial value to a final value over a given number of years — the standard way to annualize returns. Use this when an agent needs to compound annual growth rate, time-normalized.

Calculate gross profit, profit margin (profit as % of price) and markup (profit as % of cost) from a unit cost and selling price — the two numbers people constantly mix up. Use this when an agent needs to profit margin vs markup, both computed.

Estimate how many tokens a text consumes for each major model family (GPT, Claude, Gemini, Llama, DeepSeek) using a character/word heuristic that is within ~10% of real BPE tokenizers — enough for context budgeting and cost math, with zero dependencies. Use this when an agent needs to approximate token counts per LLM family, ±10%.

Calculate the API cost of an LLM call: input and output tokens × published per-million prices for 15 current models (OpenAI, Anthropic, Google, DeepSeek, xAI, Meta). Batch multiplier included for monthly estimates. Use this when an agent needs to tokens × current per-model prices = USD.

Compute exact hash digests of UTF-8 text using Web Crypto (SHA family) and a verified pure-JS MD5 for legacy checksums. Deterministic — identical input always yields the identical digest. Use this when an agent needs to sHA-256 / SHA-512 / SHA-1 / MD5, exact digests.

Generate cryptographically random UUIDv4s or time-sortable UUIDv7s from a real CSPRNG, and validate any UUID's format, version and variant bits. Use this when an agent needs to random v4, sortable v7, plus strict validation.