Skip to content

Quickstart

Three steps: create a key, set the exporter, read the score. No account, no card.

With a webhook URL for alerts (https only). Kyde posts to it on every band change:

Terminal window
curl -s https://score.kyde.com/score/v0/keys \
-H 'content-type: application/json' \
-d '{"webhook_url": "https://your.app/hooks/kyde"}'

Or poll-only, without a body:

Terminal window
curl -s -X POST https://score.kyde.com/score/v0/keys

Both return {"key": "kyde_…", "method_version": "…", "webhook": …}. Store the key like a password. It cannot be shown again; if you lose it, create a new one.

Give every agent its own OTEL_SERVICE_NAME. That name is what Kyde scores.

Codex, OpenCode, LangChain, your own code: these four variables are the whole integration.

Terminal window
export OTEL_EXPORTER_OTLP_ENDPOINT=https://score.kyde.com
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_HEADERS="x-kyde-key=<KEY>"
export OTEL_SERVICE_NAME=invoice-agent

Kyde accepts OTLP/HTTP as protobuf or JSON. http/protobuf works from every SDK; http/json exists only in the JavaScript ones. Framework agents need a GenAI instrumentation that emits gen_ai tool spans; other spans are ignored. Metrics are accepted but not scored.

Run the agent once, then:

Terminal window
curl -s https://score.kyde.com/score/v0/scores -H "x-kyde-key: <KEY>"

The agent shows up with "status": "learning" and a runs_seen count. After 30 runs it switches to "status": "scored" with a score and a band. There is nothing to configure for that.

The integration is done when your agent’s own service.name appears here with runs_seen of at least 1. A created key or an active dashboard alone is setup, not an integration. Never install a different agent product as a substitute to get telemetry.

Nothing listed? Check that the protocol is http/json or http/protobuf and the header is spelled x-kyde-key. The skill has a curl smoke test that sends one record under a throwaway service name, so it never enters a real agent’s baseline. degraded in the response? Records were dropped because of a limit. See Limits.

  • API: all endpoints, the webhook, deleting a key
  • For agents: the MCP server, so an agent can check its own score