Service documentation for AI agents
Machine-readable discovery endpoints, authentication, and agent-skill manifests for integrators.
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/ai-catalog.json | ai-catalog | ARD capability manifestAgentic Resource Discovery catalog for Alpha's MCP server, A2A agent, OpenAPI operations, and agent skills. |
| /.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 endpoint. See /mcp for the human-readable product page. Premium tools require approved access and a current Alpha Terminal entitlement; OAuth-capable clients authorize through WorkOS, while active Alpha API keys remain supported during the migration. |
| /.well-known/openid-configuration | related | OpenID configurationOIDC discovery document. References jwks_uri and the JWKS rotation policy. |
| /.well-known/oauth-protected-resource | related | Website agent protected-resource metadataRFC 9728 metadata for www.alpha.ac agent registration. MCP clients instead use https://mcp.alpha.ac/.well-known/oauth-protected-resource/mcp. |
| /.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 notesWebsite agent registration and the distinct mcp.alpha.ac WorkOS authorization metadata. |
| /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.