> ## Documentation Index
> Fetch the complete documentation index at: https://greatwait-docs.docsalot.dev/llms.txt
> Use this file to discover all available pages before exploring further.

---
name: greatwait
description: Schedule a signed HTTPS callback to a receiver the user owns, and read whether it was delivered, through Greatwait's MCP server, HTTP API or command line.
version: 22ef13bf07a3
---

# Greatwait

Use this when a user wants something to happen later, or on a recurring
schedule, by having Greatwait call an HTTPS address they control.

Source digest sha256:22ef13bf07a3e3a63b0a07b1ddfce6beb2c6fbb75d848134d86360cba884cba3. It describes the production API at build 9579cf1a1f9a and, from npm, @greatwait/api-client@0.1.0-alpha.4, @greatwait/cli@0.1.0-alpha.4 and @greatwait/contracts@0.1.0-alpha.4.

## Connect

- MCP: `https://api.greatwait.dev/mcp`, discovery at `https://api.greatwait.dev/.well-known/oauth-protected-resource/mcp`. OAuth 2.1 with S256 PKCE, or a scoped API key.
- HTTP API: `https://api.greatwait.dev`, with `Authorization: Bearer`.
- Command line: `npm install --global @greatwait/cli@0.1.0-alpha.4`.

## Reach first value

First value is reading a delivery attempt, not creating a schedule.

1. Check which service and environment you reached — `meta.version`
2. Check the credential — `schedules.list`
3. Create the destination — `endpoints.create`
4. Create the one-shot — `schedules.create`
5. Retry it safely — `schedules.create`
6. Read the schedule back — `schedules.read`
7. Wait for the occurrence to settle — `occurrences.read`
8. Read the delivery attempt — `attempts.list`
9. Clean up — `endpoints.disable`

## Rules

- A destination's signing secret and an API key are shown once. Never print, log, or pass either on a command line.
- The receiver must be the user's own HTTPS address. Never send a payload to a third-party inspection service.
- Send an `Idempotency-Key` on every create, and reuse it when retrying that create.
- Branch on a refusal's `code`, never on its prose.
- Delivery is at least once: a receiver must tolerate the same delivery twice.
- A connection acts in exactly one project and environment; it cannot be moved to another.

## Read more

- https://greatwait-docs.docsalot.dev/llms.txt
- https://greatwait-docs.docsalot.dev/llms-full.txt
- https://cdn.jsdelivr.net/npm/@greatwait/contracts@0.1.0-alpha.4/generated/v1/openapi.json