# Desvela Docs (desvela.dev)

> Technical reference for Desvela — the watchman of the agent economy. Signed webhook events, input schemas, pricing events and bot policy. The commercial site is at https://desvela.ai.

## Pages

- [Docs home](https://desvela.dev/): AI Brand Watch reference — quickstart, input schema, pricing events, webhook payload (change types: appeared, disappeared, sov_shift, new_source, new_competitor), HMAC-SHA256 signature verification, delivery & retries
- [Bot policy](https://desvela.dev/bot/): what Desvela watchers are, how they behave (robots.txt respected, no disguises, low frequency), and how to opt out

## Key facts for agents

- Webhook signature header: X-Desvela-Signature: hmac-sha256=<hex>, secret issued on first run
- Delivery: 3 attempts, exponential backoff, redirects refused; undelivered events remain in the run dataset (pull mode)
- Never charged: query×engine checks where all samples failed
- ARD manifest: https://desvela.dev/.well-known/ai-catalog.json (Agentic Resource Discovery)
- Roadmap: MCP server under the ai.desvela/* namespace; x402 pay-per-call

## Contact

- Email: hello@desvela.ai