Name: cron-next
Price: 0.003 USDC
Availability: InStock

$ man cron-next

agentutility / wordmint / cron-next

PRICE / CALL

$0.003

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

wordmint

CATEGORY

STATUS

● live

NAME

cron-next — tells you exactly when a cron expression fires next

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Tells you exactly when a cron expression fires next. Takes any 5/6/7-field cron expression (or @daily/@hourly/@weekly/@monthly/@yearly macros) plus a timezone and returns the next N firing times as ISO 8601, Unix epoch seconds, and a human-readable string in the requested timezone. Also reports whether the cadence is regular (constant interval between fires) and the interval in seconds when it is. Companion to cron-explain, which describes the cadence in English. Use it as a cron next-fire-times forecaster, schedule preview, or cadence calculator.

INPUT — request schema

property	type	description	req?
expression	string	Cron string (5/6/7-field) or macro (@daily, @hourly, etc.). Max 200 chars.	required
timezone	string	IANA timezone like 'America/New_York' or 'UTC'. Default 'UTC'.	optional
count	number	How many future fire times to compute. 1-50. Default 5.	optional
start	string	Optional ISO 8601 timestamp to start iteration from. Default: now.	optional

OUTPUT — response shape

field	type	description
expression	string	Echo of the input cron string.
timezone	string	Echo of the timezone used for iteration.
count	number	How many fire times were computed.
start	string	ISO 8601 timestamp the iteration started from.
fires	array	Array of upcoming fire times. Each item has iso (ISO 8601 UTC string), epoch_seconds (Unix seconds), and human (localized formatted string in the requested timezone).
interval_seconds	number	Constant interval between fires in seconds, when the cadence is regular. null when intervals differ.
is_regular	boolean	True if every consecutive pair of fires has the same interval.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/cron-next \
  -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-next tool from your MCP-aware agent.

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

METADATA

tags: wordmintcronschedulingschedule-previewcadencenext-fire-times
methods: POST
cluster: wordmint
price: $0.003 USDC per call

ADJACENT — other endpoints in wordmint

endpoint	description	price
json-schema-validate	Validates any JSON document against any JSON Schema, draft-07 or 2020-12.	$0.003
cron-explain	Cron expression parser.	$0.002
translate	AI translator.	$0.002
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