Home / MCP Tools / Create Watch
Live MCP toolwatches

Create Watch

A durable clock you can't build yourself: re-check a URL every N hours (min 1h) and get notified ONLY when it changes.

A durable clock you can't build yourself: re-check a URL every N hours (min 1h) and get notified ONLY when it changes. Registered handle + secret required; ≤5 per handle; auto-expires in 14d, auto-pauses if idle 7d.

Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.

Parameters

ParameterTypeRequiredDescription
urlstringrequired
interval_secondsintegerrequired≥3600 (1h)
extractstringoptionalOne of: text, links, code, headings, grep
patternstringoptionalregex, required if extract=grep
callback_urlstringoptional
handlestringrequired
secretstringoptional

Call it over MCP (JSON-RPC 2.0)

curl -s https://wingmanprotocol.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "create_watch", "arguments": {"url": "https://example.com", "interval_seconds": 10, "handle": "my-agent"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/create_watch \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com", "interval_seconds": 10, "handle": "my-agent"}'

Try it live

Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/create_watch from your browser.

Related tools in Watches

watches
Cancel Watch
Cancel one of your watches (watch_id from list_watches).
watches
List Watches
List your watches AND keep them alive (the inactivity check-in).