Qyl.Api.Contracts 17.0.14

qyl

qyl is an analytical engine built for AI agents. Services send it OpenTelemetry traces, logs and metrics; agents query it through MCP and get typed answers: what changed, why a request failed or was slow, whether a fix held, how an agent run, a release or a CI run behaved. qyl measures and correlates; the agent reasons and acts. qyl ships no dashboard or other product UI.

Built over ten months by one developer, starting with Claude Opus 4.5, using Anthropic and OpenAI models to the fullest.

Official sources

• Website: https://qyl.at
• Source: https://github.com/ANcpLua/qyl
• Hosted MCP server: https://mcp.qyl.at/mcp
• npm: qyl-mcp-server
• NuGet: qyl and Qyl.Api.Contracts

Connect an agent

Add https://mcp.qyl.at/mcp as a remote MCP server (Streamable HTTP). Sign-in is OAuth through qyl's Auth0 tenant qyl-eu. The client registers itself with a Client ID Metadata Document (CIMD) or Dynamic Client Registration (DCR), so no client ID is needed.

No tool changes or deletes telemetry; retention alone removes it. The server speaks MCP protocol 2026-07-28 and serves 2025-era clients from the same endpoint, through the MCP TypeScript SDK v2 default legacy: 'stateless'. The MCP server README lists the 24 tools, their result and error shapes and the server's configuration.

Locally, run a Collector with the qyl tool and give the MCP client bunx qyl-mcp-server --stdio as its server command:

dotnet tool install --global qyl && qyl up
bunx qyl-mcp-server --stdio    # started by the MCP client

Send telemetry

Any OpenTelemetry SDK exports to the Collector over OTLP: /v1/traces, /v1/logs and /v1/metrics over HTTP (protobuf or JSON), or gRPC. qyl up listens on http://127.0.0.1:4318 (HTTP) and 127.0.0.1:4317 (gRPC) and accepts telemetry without a key. The hosted Collector takes OTLP over HTTP at https://api.qyl.at with the project's key in the x-otlp-api-key header. An API built with Qyl.Api.Sdk exports from its first line.

Repository

https://mcp.qyl.at/healthz reports ok, or degraded while the Collector is unreachable or serves another contract revision. https://api.qyl.at/health reports the Collector's health and its contract_revision.

Build, test, release

mise install installs the pinned dotnet, bun and node. The build is Fallout, and ./eng/build.sh --help lists every target.

Documentation

• MCP server: tools, sign-in, configuration and telemetry
• Architecture
• Security policy
• Changes per version

License

qyl is free, under the MIT license. That covers the Collector, the MCP server, the contracts and every package this repository publishes: qyl, qyl.<rid>, Qyl.Api.Contracts, Qyl.Api.Sdk and Qyl.Orchestration on NuGet, and qyl-mcp-server on npm.

The plugin bundle in plugins/qyl is MIT AND Apache-2.0, because it carries the ancplua-dotnet skills under Apache-2.0, with their LICENSE and NOTICE in plugins/qyl/licenses/ancplua-dotnet/. Its MSTest skills are MIT, with their LICENSE in plugins/qyl/licenses/mstest-extensions-plugin/.