Skip to main content
Glama

Tanod Util

utilpeek: list the next run times of a cron expression

cron_next_runs
Read-onlyIdempotent

utilpeek: the next run times of a cron expression. Input: expression, optional count, timezone and start. Returns the normalized expression, timezone, start, runs and exhausted. Standard 5-field cron (minute hour day-of-month month day-of-week) or a macro (@daily, @hourly, ...); no seconds or year fields, no R/H/W. Day-of-month and day-of-week use Vixie OR semantics; an expression that never fires (Feb 30) is a 422 no_next_run (not charged); rare ones return what exists with exhausted: true. An invalid expression, start or zone is a 422 (not charged). Typically under 0.1 s. Price: USD 0.001. Free: 10 utilpeek calls per IP per UTC day. Docs: https://tanod.dev/learn/cron-next-run-api.html

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
countNoNumber of next runs (1-50, default 10).
startNoOptional ISO 8601 start (default now).
timezoneNoOptional IANA time zone (default UTC).
expressionYes5-field cron expression or macro, e.g. */15 9-17 * * MON-FRI.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
runsNo
countNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
startNo
sourceNo
timezoneNo
exhaustedNo
expressionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "count": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "error": {
      +      "description": "Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object."
      +    },
      +    "exhausted": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "expression": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "runs": {
      +      "items": {
      +        "properties": {
      +          "time": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "unix": {
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "utc": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "source": {
      +      "properties": {
      +        "library": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "license": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "tzdata": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "start": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "timezone": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources