Discovery
RFC 8288 Link relations
Every HTML document on alpha.ac advertises these resources via the Link response header. Agents may follow them without parsing HTML.
| Resource | rel | Description |
|---|---|---|
| /.well-known/api-catalog | api-catalog | API catalog (linkset)RFC 9727 / RFC 8631 linkset describing service-doc, describedby, status, and related discovery URLs. |
| /.well-known/agent-skills/index.json | related | Agent skills indexRegistered agent skills with SHA256 digests, per the agent-skills specification. |
| /.well-known/mcp/server-card.json | related | MCP server cardModel Context Protocol server card for the mcp.alpha.ac discovery endpoint. Alpha Terminal premium tools are pre-launch and require approved access. |
| /.well-known/openid-configuration | related | OpenID configurationOIDC discovery document. References jwks_uri and the JWKS rotation policy. |
| /.well-known/oauth-protected-resource | related | OAuth protected resource metadataRFC 9728 protected-resource metadata for agent authentication. |
| /.well-known/http-message-signatures-directory | http-message-signatures-directory | HTTP Message Signatures directoryJWKS for verifying signed agent/bot requests originating from Alpha (Web Bot Auth). |
| /.well-known/jwks.json | related | JWKSPublic signing keys. Rotation policy at /.well-known/jwks-rotation. |
| /.well-known/jwks-rotation | policy | JWKS rotation policyKey rotation cadence, expiration, and revocation procedures. |
| /api/public/agent-readiness | status | Agent-readiness statusMachine-readable JSON with the current served headers and validation results. |
| /api/public/health | status | HealthLiveness check. |
| /llms.txt | describedby | llms.txtPlain-text site overview for AI agents. |
| /auth.md | related | Agent authentication notesHow agents register and authenticate with Alpha endpoints. |
| /sitemap.xml | sitemap | SitemapCanonical URL index. |
The canonical API catalog is published as an RFC 9727 / RFC 8631 linkset at /.well-known/api-catalog. Service documentation is advertised with rel="service-doc" and points back to this page and to the site overview at /llms.txt.
For authentication, see /auth.md and the OIDC discovery document at /.well-known/openid-configuration. Key rotation cadence is documented at /.well-known/jwks-rotation.