# FindUtils Tool API

> Free REST API with 52 utility tools for developers and AI agents. No authentication required. Rate limit: 60 requests/minute per IP.

Base URL: https://api.findutils.com/api
OpenAPI Spec: https://api.findutils.com/api/openapi.json
MCP Server: https://mcp.findutils.com/
Documentation: https://findutils.com/api/docs

## Endpoints

- GET /api/health -- Health check, returns tool count
- GET /api/tools -- List all tools with input schemas
- GET /api/tools/:id -- Get single tool details and schema
- POST /api/tools/:id/execute -- Execute a tool (JSON body)
- GET /api/openapi.json -- Full OpenAPI 3.1 specification

## Authentication

No authentication required. Free to use.

## Rate Limits

- 60 requests per minute per IP
- 500 requests per day per IP
- 50,000 requests per day global

## Response Format

Success: {"success": true, "result": {...}, "meta": {"tool": "...", "executionMs": 0}}
Error: {"success": false, "error": {"code": "VALIDATION_ERROR", "message": "..."}}

## MCP Server

For AI assistants (Claude, ChatGPT), use the MCP server instead:
URL: https://mcp.findutils.com/
Protocol: JSON-RPC 2.0 over HTTP (Streamable HTTP transport)
Methods: initialize, tools/list, tools/call

Claude Desktop config:
{"mcpServers": {"findutils": {"url": "https://mcp.findutils.com/"}}}

## Conversion Tools

### Aspect Ratio Calculator
POST /api/tools/aspect-ratio/execute
Calculate aspect ratio from dimensions, or resize dimensions while maintaining a given aspect ratio.
Parameters:
- mode (string, required)
- width (number, required)
- height (number, required)
- new_width (number)
- new_height (number)

### BMI Calculator
POST /api/tools/bmi-calculate/execute
Calculate Body Mass Index (BMI) from height and weight. Supports metric (kg/cm) and imperial (lbs/in) units.
Parameters:
- weight (number, required)
- height (number, required)
- unit (string)

### Color Converter
POST /api/tools/color-convert/execute
Convert colors between HEX, RGB, and HSL formats.
Parameters:
- color (string, required)
- from (string, required)

### Markdown to HTML
POST /api/tools/markdown-to-html/execute
Convert Markdown text to HTML. Supports headings, bold, italic, links, code blocks, lists, blockquotes, and horizontal rules.
Parameters:
- markdown (string, required)

### Number Base Converter
POST /api/tools/number-base/execute
Convert numbers between binary, octal, decimal, and hexadecimal.
Parameters:
- value (string, required)
- from (string, required)

### Percentage Calculator
POST /api/tools/percentage/execute
Calculate percentages: X% of Y, percent change, increase, or decrease.
Parameters:
- mode (string, required)
- x (number, required)
- y (number, required)

### Roman Numeral Converter
POST /api/tools/roman-numeral/execute
Convert between Roman numerals and Arabic (decimal) numbers. Supports values 1-3999.
Parameters:
- value (string, required)

### Tip Calculator
POST /api/tools/tip-calculate/execute
Calculate tip amount, total bill, and per-person split. Supports custom tip percentages.
Parameters:
- bill_amount (number, required)
- tip_percent (number)
- people (integer)
- round_up (boolean)

### Unit Converter
POST /api/tools/unit-convert/execute
Convert between units of length, weight, temperature, data size, area, and speed.
Parameters:
- value (number, required)
- from (string, required)
- to (string, required)
- category (string)

### XML to JSON
POST /api/tools/xml-to-json/execute
Convert XML to JSON. Handles nested elements, attributes (@attributes), and text content (#text). Simple elements unwrap to string values.
Parameters:
- xml (string, required)
- pretty (boolean)

### YAML to JSON
POST /api/tools/yaml-to-json/execute
Convert YAML to JSON. Supports key-value pairs, nested objects, lists, and basic scalars (strings, numbers, booleans, null).
Parameters:
- yaml (string, required)
- pretty (boolean)

## Crypto Tools

### Hash Generator
POST /api/tools/hash/execute
Generate MD5, SHA-1, SHA-256, or SHA-512 hash of a string.
Parameters:
- text (string, required)
- algorithm (string)

### HMAC Generator
POST /api/tools/hmac/execute
Generate an HMAC signature using SHA-1, SHA-256, or SHA-512.
Parameters:
- text (string, required)
- key (string, required)
- algorithm (string)

### Password Generator
POST /api/tools/password-generate/execute
Generate cryptographically secure random passwords with configurable length and character sets.
Parameters:
- length (integer)
- include_uppercase (boolean)
- include_lowercase (boolean)
- include_digits (boolean)
- include_symbols (boolean)
- exclude_ambiguous (boolean)
- count (integer)

### Random String Generator
POST /api/tools/random-string/execute
Generate cryptographically secure random strings with configurable length and character sets.
Parameters:
- length (integer)
- charset (string)
- custom_chars (string)
- count (integer)

## Data Tools

### CSV to JSON Converter
POST /api/tools/csv-to-json/execute
Convert CSV text to a JSON array of objects. First row is used as headers.
Parameters:
- csv (string, required)
- delimiter (string)
- coerce (boolean)

### JSON Flatten
POST /api/tools/json-flatten/execute
Flatten nested JSON objects to a single level using dot-notation keys. Arrays become indexed keys.
Parameters:
- json (string, required)
- separator (string)

### JSON Formatter / Minifier
POST /api/tools/json-format/execute
Format (pretty-print) or minify a JSON string.
Parameters:
- json (string, required)
- action (string)
- indent (integer)

### JSON Query
POST /api/tools/json-query/execute
Query JSON data using dot-notation paths (e.g., user.name, items[0].price). Supports nested objects and array indexing.
Parameters:
- json (string, required)
- path (string, required)

### JSON to CSV Converter
POST /api/tools/json-to-csv/execute
Convert a JSON array of objects to CSV format.
Parameters:
- json (string, required)
- delimiter (string)
- includeHeaders (boolean)

### JSON Unflatten
POST /api/tools/json-unflatten/execute
Convert flat dot-notation key-value JSON back into a nested JSON object.
Parameters:
- json (string, required)
- separator (string)

### JSON Validator
POST /api/tools/json-validate/execute
Check whether a string is valid JSON and get basic structure info.
Parameters:
- json (string, required)

## Datetime Tools

### Date Difference Calculator
POST /api/tools/date-diff/execute
Calculate the difference between two dates in various units.
Parameters:
- from (string, required)
- to (string)

### Unix Timestamp Converter
POST /api/tools/unix-timestamp/execute
Convert Unix timestamps to human-readable dates and vice versa.
Parameters:
- action (string, required)
- value (string)

## Developer Tools

### chmod Calculator
POST /api/tools/chmod-calculate/execute
Convert between numeric (755) and symbolic (rwxr-xr-x) chmod permission formats, with human-readable description.
Parameters:
- mode (string, required)

### CIDR Calculator
POST /api/tools/cidr-calculate/execute
Calculate network address, broadcast address, host range, subnet mask, and host count from a CIDR notation (e.g. 192.168.1.0/24).
Parameters:
- cidr (string, required)

### Cloudflare Cost Calculator
POST /api/tools/cloudflare-cost-calculate/execute
Estimate monthly Cloudflare developer platform costs. Supports Workers, D1, R2, KV, and Durable Objects with free tier and Workers Paid ($5/mo) plan calculations.
Parameters:
- plan (string)
- workers_requests_m (number)
- workers_cpu_ms_m (number)
- workers_build_min (number)
- d1_reads_m (number)
- d1_writes_m (number)
- d1_storage_gb (number)
- r2_storage_gb (number)
- r2_class_a_m (number)
- r2_class_b_m (number)
- kv_reads_m (number)
- kv_writes_m (number)
- kv_storage_gb (number)
- do_requests_m (number)
- do_duration_k_gbs (number)
- do_reads_m (number)
- do_writes_m (number)
- do_storage_gb (number)

### Credit Card Validator
POST /api/tools/credit-card-validate/execute
Validate credit card numbers using the Luhn algorithm and detect card type (Visa, Mastercard, Amex, etc.).
Parameters:
- number (string, required)

### Cron Expression Describer
POST /api/tools/cron-describe/execute
Describe a cron expression in plain English. Supports standard 5-field and 6-field (with seconds) expressions.
Parameters:
- expression (string, required)

### Email Validator
POST /api/tools/email-validate/execute
Validate email address format using RFC 5322 rules. Returns validation details including local part, domain, and any issues found.
Parameters:
- email (string, required)

### IP Address Validator
POST /api/tools/ip-validate/execute
Validate IPv4 and IPv6 addresses and return type, class, and details.
Parameters:
- ip (string, required)

### JWT Decoder
POST /api/tools/jwt-decode/execute
Decode a JWT token and inspect its header and payload. Does NOT verify the signature.
Parameters:
- token (string, required)

### Meta Tag Fetcher
POST /api/tools/meta-fetch/execute
Fetch title, meta description, Open Graph tags, and favicon from a URL.

### Random Number Generator
POST /api/tools/random-number/execute
Generate cryptographically secure random integers or floats within a specified range.
Parameters:
- min (number)
- max (number)
- count (integer)
- type (string)
- decimal_places (integer)
- unique (boolean)

### Regex Tester
POST /api/tools/regex-test/execute
Test a regular expression against text and return all matches with groups.
Parameters:
- pattern (string, required)
- text (string, required)
- flags (string)

### UUID Generator
POST /api/tools/uuid/execute
Generate one or more UUID v4 values.
Parameters:
- count (integer)
- uppercase (boolean)

## Encoding Tools

### Base64 Encoder / Decoder
POST /api/tools/base64/execute
Encode text to Base64 or decode Base64 back to text.
Parameters:
- action (string, required)
- text (string, required)

### Morse Code Encoder / Decoder
POST /api/tools/morse-code/execute
Encode text to Morse code or decode Morse code back to text. Letters are separated by spaces, words by " / ".
Parameters:
- action (string, required)
- text (string, required)

### QR Code (Text/ASCII)
POST /api/tools/qr-text/execute
Generate a QR code as ASCII art. Supports up to ~100 characters. Returns the matrix as text using block characters, dots, or hash symbols.
Parameters:
- text (string, required)
- style (string)

### URL Encoder / Decoder
POST /api/tools/url-encode/execute
Encode or decode URL components.
Parameters:
- action (string, required)
- text (string, required)
- mode (string)

## Text Tools

### Text Case Converter
POST /api/tools/case-convert/execute
Convert text between different cases: uppercase, lowercase, title, camelCase, PascalCase, snake_case, kebab-case, and CONSTANT_CASE.
Parameters:
- text (string, required)
- to (string, required)

### HTML Tag Stripper
POST /api/tools/html-strip/execute
Strip HTML tags from text and return plain text. Optionally decode HTML entities.
Parameters:
- html (string, required)
- decode_entities (boolean)
- preserve_whitespace (boolean)

### Line Deduplicator
POST /api/tools/line-dedupe/execute
Remove duplicate lines from text. Optionally case-insensitive, and optionally show only the duplicates.
Parameters:
- text (string, required)
- case_sensitive (boolean)
- keep (string)
- trim_before_compare (boolean)
- show_duplicates_only (boolean)

### Line Sorter
POST /api/tools/line-sort/execute
Sort lines of text alphabetically, numerically, by length, or randomly.
Parameters:
- text (string, required)
- order (string)
- case_sensitive (boolean)
- ignore_leading_whitespace (boolean)

### Lorem Ipsum Generator
POST /api/tools/lorem-ipsum/execute
Generate placeholder "Lorem Ipsum" text by words, sentences, or paragraphs.
Parameters:
- type (string)
- count (integer)
- startWithLorem (boolean)

### Slug Generator
POST /api/tools/slug-generate/execute
Generate URL-friendly slugs from text. Converts to lowercase, replaces spaces and special characters with hyphens.
Parameters:
- text (string, required)
- separator (string)
- max_length (integer)

### String Escape / Unescape
POST /api/tools/string-escape/execute
Escape or unescape strings for JSON, HTML, URL, regex, or SQL contexts.
Parameters:
- text (string, required)
- action (string, required)
- format (string, required)

### Text Repeater
POST /api/tools/text-repeat/execute
Repeat text a specified number of times with an optional separator between repetitions.
Parameters:
- text (string, required)
- count (integer, required)
- separator (string)

### Text Reverser
POST /api/tools/text-reverse/execute
Reverse a string character by character, or reverse the order of words or lines.
Parameters:
- text (string, required)
- mode (string)

### Text Truncator
POST /api/tools/text-truncate/execute
Truncate text to a maximum length with configurable ellipsis. Can truncate by characters or words.
Parameters:
- text (string, required)
- max_length (integer, required)
- mode (string)
- ellipsis (string)
- break_on_word (boolean)

### Whitespace Cleaner
POST /api/tools/whitespace-clean/execute
Clean whitespace from text: trim, collapse multiple spaces, normalize line endings, remove blank lines, or strip all whitespace.
Parameters:
- text (string, required)
- trim (boolean)
- trim_lines (boolean)
- collapse_spaces (boolean)
- remove_blank_lines (boolean)
- normalize_line_endings (string)

### Word Counter
POST /api/tools/word-count/execute
Count words, characters, sentences, paragraphs, and estimate reading time.
Parameters:
- text (string, required)