crontap-quickstart skill by crontap

Crontap quickstart

Crontap provides three related resources:

A schedule sends an HTTP request on a cron or plain-English cadence.
An uptime monitor probes a URL and records availability.
A heartbeat expects an existing job to ping after it runs.

MCP lets the current agent manage these resources. Crontap owns HTTP scheduling and observability, not the lifecycle of the MCP client.

Prerequisites

Before using the required tools, check whether they are available. If any are missing, stop and offer the user exactly two choices:

Connect Crontap MCP at https://mcp.crontap.com/mcp. MCP access works on every Crontap tier.
Configure $CRONTAP_CLIENT_ID and $CRONTAP_API_KEY for the raw API. Raw API access requires Ultra.

Do not silently choose a path or continue until the user selects one.

Connect the remote MCP server at https://mcp.crontap.com/mcp and complete OAuth in the target Crontap account.
Know the intended endpoint, local timezone, and desired failure signal.
Treat endpoint authorization values and heartbeat ping URLs as secrets.

Workflow

Call get_account_usage before creating resources when capacity is uncertain.
Compare usage.combined with caps.combined and inspect feature flags.
Choose a schedule for outbound execution, a monitor for endpoint availability, or a heartbeat for missed check-ins.
Call list_timezones when the exact IANA timezone is uncertain.
Hand off to the focused skill for creation and verification.

MCP examples

Inspect the active tier, usage, caps, features, and plan options:

{
  "tool": "get_account_usage",
  "arguments": {}
}

Find accepted timezone names:

{
  "tool": "list_timezones",

Use the exact returned timezone, such as Europe/Copenhagen. Do not substitute a fixed UTC offset for a local-time business schedule.

REST fallback

The public API is a fallback only for accounts with Ultra API access. MCP is not Ultra-only.

Keep both values in environment variables or a secret manager. Never put them in a repository, agent transcript, URL, or example output.

Safety and plan limits

Starter, Pro, and Ultra use one combined cap for schedules, monitors, and heartbeats. Some resource-specific caps and cadence floors also apply.
Treat the returned account object as authoritative. Do not hard-code prices or assume a feature from the tier name.
If a tool returns a structured plan-limit error, present its ordered four-option ladder and identify the smallest viable option. Do not invent a fifth option or hide the all-plans URL.
Confirm the target account before any write operation.

Troubleshooting

If OAuth fails, reconnect the MCP server in the client and retry once.
If a timezone search returns no match, try a city or region substring.
If REST returns API_REQUIRES_ULTRA, continue through MCP or let the user choose an Ultra option.
If MAX_ITEMS_REACHED appears, do not retry the same create call unchanged.

References