WellKnownAI — Registry & Tools (MCP/agents.json compatible)

Goal: host AI Manifest field definitions, examples, and public snapshots.

AI Manifest (v0.1) — field quicklist

• manifest_version, provider, spec.openapi_url, spec.schemas[]
• servers[], capabilities[], resources[], prompts[]
• auth.jwks_uri, receipts.signature[], contact.*

Example entry

{
  "domain": "example.com",
  "manifest": "https://example.com/.well-known/ai.json",
  "openapi": "https://api.example.com/openapi.yaml",
  "jwks_uri": "https://example.com/.well-known/jwks.json",
  "servers": [{"type":"rest","url":"https://api.example.com"}],
  "capabilities": ["search","vector.upsert","invoice.create"],
  "status": "active"
}

Cross links: AI Manifest · AgentPKI · AgentURN

Registry & Downloads

• Registry Viewer
• Releases (snapshots & diffs)

Tools / Examples

// OpenAPI fragment
paths:
  /search:
    post:
      requestBody:
        content:
          application/json:
            schema: { $ref: "#/components/schemas/SearchInput" }

5-minute Getting Started (Provider)

1. Create /.well-known/ai.json (minimal example):

   {
     "manifest_version": "0.1",
     "provider": { "name": "Your Inc.", "homepage": "https://your-domain" },
     "spec": { "schemas": ["https://your-domain/schemas/YourSchema.json"] },
     "servers": [{ "type": "rest", "url": "https://api.your-domain" }],
     "capabilities": ["schemas.list", "urn:agent:skill:your-domain:example.v1"],
     "auth": { "jwks_uri": "https://your-domain/.well-known/jwks.json", "schemes": ["bearer"] }
   }

2. Publish JWKS at /.well-known/jwks.json (placeholder for demo; use a real public key in production):

   {
     "keys": [{
       "kty": "RSA",
       "kid": "2025-01-01-rsa",
       "use": "sig",
       "alg": "RS256",
       "n": "base64url...",
       "e": "AQAB"
     }]
   }

3. (Optional) Publish CRL at /.well-known/ai-crl.json to revoke keys or mark compliance status.
4. Validate locally using the CLI provided in this repo:

   node ai-manifest-kit/scripts/validate-ai.mjs --file .well-known/ai.json --out _reports/ai_local.json\nnode ai-manifest-kit/scripts/validate-jwks.mjs --file .well-known/jwks.json --out _reports/jwks_local.json\nnode ai-manifest-kit/scripts/validate-crl.mjs  --file .well-known/ai-crl.json --out _reports/crl_local.json

5. Wire CI: This repo ships validate-registry.yml and validate-registry-remote.yml. Changes to registry.json are validated automatically.
6. (Optional) To be listed, open a PR to add your domain to wellknownai.org's registry.json (see Registry Viewer on the site).

Notes: Use HTTPS and absolute URLs. Send ETag and Last-Modified and a Cache-Control (e.g., max-age=600+). Rotate JWKS by kid with an overlap window (≥ 7 days): add new key first, then remove the old one.