--- name: x402-utils.558686.xyz description: x402-utils.558686.xyz provides a small set of general-purpose string and identifier utility functions exposed as paid x402 endpoints. It covers structural text analysis, URL parsing, slug generation, and UUID v4 creation. All operations are deterministic transformations with no semantic or AI-based processing. host: x402-utils.558686.xyz --- # x402-utils.558686.xyz This host serves agents that need lightweight, stateless utility operations without implementing the logic locally. It targets use cases such as pre-processing text before storage, decomposing URLs for routing logic, generating stable slugs for identifiers, and minting fresh UUIDs for keys or trace IDs. It is a utility-layer host, not an analytics or NLP host. ## When to use this host Use this host when an agent needs simple, stateless string or identifier operations without writing local utility code: counting text metrics, parsing URL components, generating slugs, or minting UUIDs. Do not use it for semantic text processing, NLP, sentiment analysis, or summarization — those require a language model or dedicated NLP service. Do not use it for UUID formats other than v4 (v1, v5, ULID); use a local crypto library instead. Do not use it for URL encoding, decoding, or construction; it only parses existing absolute URLs. For any operation requiring stateful context, persistence, or chained business logic beyond these primitives, a different host is needed. ## Capabilities ### Text Utilities Provides structural analysis and transformation of raw text strings, covering both metric extraction and slug generation for downstream use in identifiers or routing. - **`compute-text-stats`** — Counts characters, bytes, words, lines, paragraphs, and estimated reading time for a given text string via a paid x402 endpoint. - **`slugify-text`** — Converts a text string into a URL-friendly slug and returns the slug, delimiter character, and character length. ### URL Parsing Decomposes an absolute URL into discrete structured fields such as protocol, host, pathname, and query parameters for validation or downstream processing. - **`parse-url-components`** — Parses an absolute URL into structured components including protocol, host, pathname, search string, query parameters, and origin. ### Identifier Generation Generates one or more UUID v4 values suitable for use as database keys, test payloads, or agent trace identifiers. - **`generate-uuid-v4`** — Generates one or more UUID v4 values via a paid x402 endpoint, returning each UUID as a string in an array. ## Workflows ### Slug-Then-UUID Resource Keying *Use when an agent needs to create a new resource that requires both a human-readable URL slug derived from a title and a unique machine identifier for the database record.* 1. **`slugify-text`** — Convert the resource title or label into a stable URL-safe slug to use as the public-facing identifier or route segment. 2. **`generate-uuid-v4`** — Mint a UUID v4 to serve as the internal primary key for the same resource, decoupled from the slug. ### URL Decompose and Slug Normalize *Use when an agent needs to extract the pathname from an existing URL and then produce a normalized slug from that path segment for indexing or deduplication.* 1. **`parse-url-components`** — Parse the input URL to extract the pathname or hostname component that needs to be normalized. 2. **`slugify-text`** — Convert the extracted path segment into a canonical slug for use as a stable index key or identifier. ## Skill reference ### `compute-text-stats` **Text Stats** — Counts characters, bytes, words, lines, paragraphs, and estimated reading time for a given text string via a paid x402 endpoint. *Use when:* Use when an agent needs deterministic text metrics (character count, word count, line count, paragraph count, byte size, reading time) for a supplied string without implementing the counting logic locally. *Not for:* Do not use for NLP analysis, sentiment, summarization, or any semantic text processing — this endpoint only returns raw structural counts. **Inputs:** - `text` (string, required) — The text string to analyze. All metrics are computed from this value. **Returns:** Returns ok=true with a result object containing characters, bytes, words, lines, paragraphs, readingTimeMinutes, and wordsPerMinute, plus x402 receipt metadata. **Example:** `{"text": "one two\nthree"}` --- ### `parse-url-components` **URL Parse Tool** — Parses an absolute URL into structured components including protocol, host, pathname, search string, query parameters, and origin. *Use when:* Use when an agent needs to decompose a URL string into discrete machine-readable fields such as hostname, pathname, query parameters, port, or origin for downstream processing or validation. *Not for:* Do not use for URL encoding/decoding or URL construction; this tool only parses an existing absolute URL into its components. **Inputs:** - `url` (string, required) — The absolute URL to parse into structured components. **Returns:** Returns ok=true and a result object with href, protocol, host, hostname, port, pathname, search, hash, query key-value map, and origin parsed from the input URL. **Example:** `{"url": "https://x402-utils.558686.xyz/v1/tools/hash-text?algorithm=sha256"}` --- ### `slugify-text` **Slugify Text** — Converts a text string into a URL-friendly slug and returns the slug, delimiter character, and character length. *Use when:* Use when an agent needs to generate a stable, URL-safe slug from a label, title, or route name before constructing URLs, identifiers, or file paths. *Not for:* Do not use for decoding or parsing existing slugs back into readable text; this endpoint only converts text to slugs, not the reverse. **Inputs:** - `text` (string, required) — The input text to convert into a URL-friendly slug. **Returns:** Returns ok=true with result.slug (e.g. "x402-seller-growth-tools"), delimiter ("-"), and slug character length (24), plus a receiptEvidence object containing a payment receipt URL. **Example:** `{"text": "x402 Seller Growth Tools"}` --- ### `generate-uuid-v4` **UUID v4 Generator** — Generates one or more UUID v4 values via a paid x402 endpoint, returning each UUID as a string in an array. *Use when:* Use when an agent needs one or more fresh UUID v4 values for IDs, test payloads, database keys, or agent trace identifiers. *Not for:* Do not use for UUID versions other than v4 (e.g. v1, v5, or ULID); use a local crypto library or a different endpoint for those formats. **Inputs:** - `count` (integer, required) — Number of UUID v4 values to generate. Must be a positive integer. **Returns:** Returns ok=true with result.uuids array containing the requested number of UUID v4 strings, plus a receiptEvidence object with payment receipt details. **Example:** `GET https://x402-utils.558686.xyz/v1/tools/uuid?count=1` ---