{
  "protocolVersion": "1.0",
  "name": "Clockrook",
  "description": "Scheduled jobs for AI agents. Send one skill per message as a data part { \"skill\": \"\u003cid>\", \"arguments\": { ... } }; argument schemas are the MCP tools of the same names at https://clockrook.com/mcp. One account works on every agent-first site.",
  "url": "https://clockrook.com/a2a",
  "preferredTransport": "JSONRPC",
  "supportedInterfaces": [
    {
      "url": "https://clockrook.com/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "additionalInterfaces": [
    {
      "url": "https://clockrook.com/a2a",
      "transport": "JSONRPC"
    }
  ],
  "provider": {
    "organization": "API Evangelist",
    "url": "https://clockrook.com"
  },
  "version": "0.1.0",
  "documentationUrl": "https://clockrook.com/developers/",
  "iconUrl": "https://clockrook.com/favicon.svg",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extendedAgentCard": false
  },
  "securitySchemes": {
    "oauth2": {
      "type": "oauth2",
      "description": "OAuth 2.1, authorization code with PKCE and dynamic client registration; the owner approves with a link from their email.",
      "oauth2MetadataUrl": "https://clockrook.com/.well-known/oauth-authorization-server",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://clockrook.com/v1/oauth/authorize",
          "tokenUrl": "https://clockrook.com/v1/oauth/token",
          "scopes": {
            "jobs:read": "List your Clockrook jobs and their run history.",
            "jobs:manage": "Create, run, pause, resume and delete jobs. Runs beyond the free allowance spend your prepaid balance.",
            "account:read": "See your balance, strikes and settings, turn auto-recharge off, and fetch links for you to manage the account."
          }
        }
      }
    },
    "apiKey": {
      "type": "http",
      "scheme": "bearer",
      "description": "An API key from the create_account skill or POST /v1/accounts, shown once."
    }
  },
  "security": [
    {
      "oauth2": []
    },
    {
      "apiKey": []
    },
    {}
  ],
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "skills": [
    {
      "id": "create_job",
      "name": "Schedule a job",
      "description": "Run something later or repeatedly. kind ping delivers your payload (a reminder or callback); uptime checks check_url and alerts after alert_after failures; watch fetches check_url and delivers a diff when it changes. schedule is one of {at}, {every_seconds} or {cron (5-field), timezone}. target is {url} (signed POST, secret shown once), {inbox_id} (a Hookpie inbox) or {email: true}.",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"create_job\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "list_jobs",
      "name": "List jobs",
      "description": "Your jobs, their schedules and last run.",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"list_jobs\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_job",
      "name": "One job",
      "description": "A job and its state.",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"get_job\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "run_job",
      "name": "Run a job now",
      "description": "Run it immediately, outside its schedule (metered like any run).",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"run_job\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "list_runs",
      "name": "Run history",
      "description": "Recent runs: outcome, status, latency, delivery.",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"list_runs\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pause_job",
      "name": "Pause a job",
      "description": "Stop it running until resumed.",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"pause_job\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "resume_job",
      "name": "Resume a job",
      "description": "Start a paused job again.",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"resume_job\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "delete_job",
      "name": "Delete a job",
      "description": "Remove the job and its schedule.",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"delete_job\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "create_account",
      "name": "Create an account",
      "description": "Create an account (one account and one prepaid balance work on every agent-first site: Yawplet, Yarnhen, Hagglebee, Eventwren, Hookpie, Clockrook, Rainplover). accept_terms must be true only when the human owner accepts them. Returns an API key once; give account_url to the owner to verify their email.",
      "tags": [
        "scheduler",
        "public"
      ],
      "examples": [
        "{\"skill\":\"create_account\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_account",
      "name": "Account balance and standing",
      "description": "Balance (micro-dollars), whether email is verified and a card or wallet is on file, and a fresh account_url for the owner.",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"get_account\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_usage",
      "name": "This period's usage",
      "description": "Metered use this month (or day), the free allowance and the unit price.",
      "tags": [
        "scheduler",
        "account"
      ],
      "examples": [
        "{\"skill\":\"get_usage\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_pricing",
      "name": "Prices",
      "description": "Free allowances and per-unit prices in micro-dollars (1 USD = 1,000,000).",
      "tags": [
        "scheduler",
        "public"
      ],
      "examples": [
        "{\"skill\":\"get_pricing\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ]
}
