io.github.IdoAzaCalls/cron-explainer
Cron expression parser: explains any cron + returns next N fire times. Timezone-aware.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http cron-explainer 'https://cron-explainer.cron-explainer-prod.workers.dev/mcp'
{
"mcpServers": {
"cron-explainer": {
"type": "http",
"url": "https://cron-explainer.cron-explainer-prod.workers.dev/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
cron-explainer
A tiny pay-per-call API that parses cron expressions, returns the next N fire times, and produces a short English description. Timezone-aware (IANA).
Live: https://cron-explainer.cron-explainer-prod.workers.dev/ Pricing: 0.01 EUR per successful call, prepaid via Stripe Checkout in packs of 500 / 5,000 / 50,000 calls. Non-2xx responses are refunded. No subscription. Keys never expire.
Quick start
- Get a key at https://cron-explainer.cron-explainer-prod.workers.dev/ (Stripe Checkout, €5 minimum).
- Copy the key — it's shown exactly once.
- Call the API:
curl -X POST https://cron-explainer.cron-explainer-prod.workers.dev/v1/explain \
-H "content-type: application/json" \
-H "x-api-key: $YOUR_KEY" \
-d '{"cron":"0 9 * * 1-5","tz":"Europe/Lisbon","n":3}'
Response:
{
"input": {"cron":"0 9 * * 1-5","tz":"Europe/Lisbon","n":3},
"valid": true,
"description": "At 09:00, Monday through Friday",
"next": ["2026-04-24T08:00:00.000Z","2026-04-27T08:00:00.000Z","2026-04-28T08:00:00.000Z"],
"flags": {"dst_transition_ahead": false, "ambiguous": false, "notes": []},
"errors": []
}
Check remaining balance:
curl -H "x-api-key: $YOUR_KEY" \
https://cron-explainer.cron-explainer-prod.workers.dev/v1/balance
MCP
The server is listed on the official MCP registry as
io.github.IdoAzaCalls/cron-explainer with a Streamable HTTP endpoint at
POST /mcp. It exposes one tool, explain_cron. Pass your x-api-key as
an HTTP header on the MCP transport; billing is identical to the REST path.
Registry entry: https://registry.modelcontextprotocol.io/v0/servers?search=cron-explainer
Endpoints
| Method | Path | Purpose |
|---|---|---|
POST | /v1/explain | Parse + describe + next fire times (billed) |
GET | /v1/balance | Remaining balance for an x-api-key |
POST | /v1/checkout | Create a Stripe Checkout Session |
GET | /v1/schema | JSON Schema for request/response |
POST | /mcp | MCP Streamable HTTP (JSON-RPC 2.0) |
GET | /.well-known/mcp.json | Static tool manifest |
GET | /health | Liveness probe |
GET | /legal/{tos,privacy,disclaimer,notices} | Legal docs |
Limits
- Cron: 5-field POSIX/Vixie syntax (minute, hour, day-of-month, month, day-of-week).
- Timezones: IANA names (e.g.
Europe/Lisbon,America/Los_Angeles). Defaults toUTC. nclamps to[1, 100].- Best-effort accuracy. See
/legal/disclaimerfor warranty terms. - Zero PII: inputs are cron strings and IANA timezones only. Request and response bodies are never logged.
Stack
TypeScript on Cloudflare Workers. Cron parsing via
croner (MIT). English descriptions via
cronstrue (MIT). Full NOTICE
text at /legal/notices.
Contact
azariaido@gmail.com — billing issues, bug reports, custom pricing.
Questions fréquentes
Qu'est-ce que io.github.IdoAzaCalls/cron-explainer ?
Cron expression parser: explains any cron + returns next N fire times. Timezone-aware.
Comment installer io.github.IdoAzaCalls/cron-explainer ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http cron-explainer 'https://cron-explainer.cron-explainer-prod.workers.dev/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.IdoAzaCalls/cron-explainer ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.IdoAzaCalls/cron-explainer est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.IdoAzaCalls/cron-explainer ?
Il est publié par IdoAzaCalls. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.