Name: cron-explain
Price: 0.002 USDC
Availability: InStock

$ man cron-explain

agentutility / wordmint / cron-explain

PRICE / CALL

$0.002

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

wordmint

CATEGORY

STATUS

● live

NAME

cron-explain — cron expression parser

SYNOPSIS

POST https://x402.agentutility.ai/cron-explain
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Cron expression parser. Takes a 5/6/7-field cron expression or @yearly/@monthly/@weekly/@daily/@hourly macro and returns a plain-English explanation, frequency bucket, validation result, and a runs-per-day estimate. Useful for explaining a schedule to a human, validating a cron string, or generating a cadence summary.

INPUT — request schema

property	type	description	req?
expression	string	Cron expression (5, 6, or 7 fields) or macro like @daily. Max 500 chars.	required
timezone	string	IANA timezone name for the explanation, e.g. 'America/New_York'. Optional, default UTC.	optional

OUTPUT — response shape

field	type	description
expression	string	Echoes the input cron expression or macro that was parsed.
timezone	string	Timezone applied when interpreting the schedule, echoed back from input or defaulted.
explanation	string	Plain-English sentence describing when the cron fires (e.g. 'Every Monday at 9:00 AM').
frequency	string	Frequency bucket label such as minutely, hourly, daily, weekly, monthly, or yearly.
fields	object	Parsed cron fields keyed by name (minute, hour, day, month, weekday, and optional second/year).
field_explanations	object	Per-field plain-English breakdown keyed by field name (e.g. minute: 'at minute 0').
is_valid	boolean	True if the cron expression parsed cleanly with no syntax or range errors.
validation_notes	array	Array of warnings or error strings flagged during parsing (empty when fully valid).
estimated_runs_per_day	number	Approximate number of times the schedule fires in a 24-hour period.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/cron-explain \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the cron-explain tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: cronscheduledeveloperexplainsysadmin
env: VENICE_API_KEY
methods: POST
cluster: wordmint
price: $0.002 USDC per call

ADJACENT — other endpoints in wordmint

endpoint	description	price
translate	Translate text between languages with native-sounding output instead of literal word-for-word conversion.	$0.002
cron-next	Tells you exactly when a cron expression fires next.	$0.003
json-schema-validate	Validates any JSON document against any JSON Schema, draft-07 or 2020-12.	$0.003
brand-tagline	Generates brand taglines and slogans for launch pages, X bios, email copy, and product cards.	$0.005
brand-tagline-generate	Generates tagline options for a brand or startup from its name, concept, audience, and tone.	$0.005
card-resolve	Normalizes free-form graded card text into a canonical card object.	$0.005
content-simhash	Fingerprints text with a 64-bit SimHash for near-duplicate detection, computed entirely locally.	$0.005
cron-parse	Cron parser.	$0.005