Skip to main content
Glama

Schedule a callback

schedule_callback

Schedules a delayed HTTP callback: give a public URL, an optional JSON body, optional headers and a delay of 60 seconds to 7 days (or an absolute time), and the URL is called at that time (POST when a body was given, otherwise GET), with one retry and a 10-second timeout. The answer carries a free status URL that reports whether it fired and what the callee answered. A request that is refused is not charged. Price: $0.005 per call in USDC (x402).

Input Schema

NameRequiredDescriptionDefault
atNoAbsolute time with a timezone, e.g. 2026-10-28T15:00:00Z, 60 seconds to 7 days ahead. Give this or delaySeconds, not both.
urlYesPublic http(s) URL to call. Private, local and cloud-metadata addresses are refused, when scheduled and again when fired. Redirects are reported, not followed.
bodyNoAny JSON value. Present: the callback is a POST with this as its JSON body (up to 65536 bytes). Absent: a GET.
headersNoExtra request headers, up to 16, printable ASCII values up to 1024 characters. host, content-length and connection-level headers are refused.
delaySecondsNoSeconds from now, 60 to 604800. Give this or at, not both.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations: one retry, 10-second timeout, redirects reported rather than followed, private/local/cloud-metadata URLs refused at both schedule and fire time, refused requests not charged, and a status URL for checking outcomes. It is consistent with readOnlyHint=false and openWorldHint=true since it performs an outbound write-ish action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and price anchor the start and end, with the operational constraints in between; nearly every clause carries information. It is dense as a single long sentence, which slightly hurts scanability but avoids padding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description compensates by describing the return (a free status URL reporting whether it fired and the callee's answer) and the failure/cost model. For a paid, open-world async tool this covers everything an agent needs to invoke and interpret it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description still adds value by explaining the conditional semantics of body (body present means POST, absent means GET) and by restating the delay bounds and the 'this or that, not both' constraints on at/delaySeconds. It stops short of adding anything about headers or body size beyond what the schema already documents.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource: 'Schedules a delayed HTTP callback', then immediately defines the mechanics (URL, body, headers, delay). This is unmistakably distinct from the siblings host_file and render_page, which deal with storage and rendering rather than timed outbound requests.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear operating context – delay window of 60 seconds to 7 days or an absolute time, and the POST-vs-GET condition based on body presence – so an agent knows when this tool applies. It does not explicitly compare against the sibling tools or state when not to use it, which keeps it below a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources