Telemetry
Spectral collects lightweight, anonymous usage statistics for community catalog tools. This page explains what is collected, when, and why.
What is collected
Section titled “What is collected”Once a day, Spectral reports the following for each community-installed tool collection:
- Call count — how many times each tool was invoked since the last report.
- Error count — how many of those invocations resulted in an error.
That’s it. No request payloads, no response bodies, no credentials, and no personally identifiable information.
What is not collected
Section titled “What is not collected”- Private tools are excluded. Tools you generated yourself and did not publish to the catalog are never reported. Telemetry only covers tools installed from the community catalog.
- No content data. The actual parameters your agent sends and the responses it receives are never transmitted.
Opt-out
Section titled “Opt-out”Telemetry is opt-out. You choose whether to enable it when you configure your API key. You can change this setting at any time.
When it happens
Section titled “When it happens”Telemetry is sent at most once every 24 hours.
Why it matters
Section titled “Why it matters”Usage and error data serve two purposes:
- Reliability signal. When browsing the catalog, you can see each tool’s success rate and usage volume. This helps you choose well-maintained, battle-tested tools over untested ones.
- Feedback for authors. Tool publishers can see whether their collections are used and how often they fail, so they can prioritize fixes and improvements.
The data is aggregated and displayed publicly on the catalog search results and the catalog web page.