# auth.md — MovingCostLab

## Status: under construction — authentication is not available

MovingCostLab is a public, read-only content site. There are no accounts, no login, and no token issuance today. Do not attempt registration, login, or token exchange while this document says available=false: those operations are a planned contract only, not an active service.

Planned operations (all currently return HTTP 503 with `temporarily_unavailable` and store nothing):
- Authorization: https://movingcostlab.com/agent-auth/authorize
- Token: https://movingcostlab.com/agent-auth/token
- Registration: https://movingcostlab.com/agent-auth/register
- Claim: https://movingcostlab.com/agent-auth/claim

Planned final credential type: access_token, for an anonymous identity type only, with scope `site:read`. No launch date is set (launch_date=null). The disabled JWKS at https://movingcostlab.com/.well-known/jwks.json contains no keys (`keys:[]`) and must not be treated as working token validation.

## Agent registration

Agent audience: AI agents that want to read MovingCostLab's published moving-cost articles.

Registration method (planned, not active): anonymous registration.
- register_uri: https://movingcostlab.com/agent-auth/register
- claim_uri: https://movingcostlab.com/agent-auth/claim
- identity_types_supported: anonymous
- credential_types_supported: access_token
- scopes_supported: site:read
- bearer_methods_supported: header
- authorization_endpoint: https://movingcostlab.com/agent-auth/authorize
- token_endpoint: https://movingcostlab.com/agent-auth/token
- resource: https://movingcostlab.com
- authorization_servers: https://movingcostlab.com
- skill: https://movingcostlab.com/auth.md

How registration works when it launches (planned design, do not attempt today): an agent would register anonymously at register_uri, claim an access_token credential at claim_uri, and then present that token in the Authorization header (bearer, header method) for scope site:read. Today, while status is under_construction and available=false, agents must not attempt any of those steps, because the endpoints return HTTP 503 and issue nothing. Registration is not required for the public read-only service below.

```json
{
  "agent_auth": {
    "status": "under_construction",
    "available": false,
    "capabilities_status": "planned_contract_only",
    "skill": "https://movingcostlab.com/auth.md",
    "register_uri": "https://movingcostlab.com/agent-auth/register",
    "claim_uri": "https://movingcostlab.com/agent-auth/claim",
    "identity_types_supported": ["anonymous"],
    "anonymous": {
      "status": "under_construction",
      "available": false,
      "capabilities_status": "planned_contract_only",
      "credential_types_supported": ["access_token"]
    },
    "scopes_supported": ["site:read"],
    "bearer_methods_supported": ["header"]
  }
}
```

## What works today without authentication

Use the public read-only service. No signup, no token, no WWW-Authenticate challenge is required for it:
- Agent entry: https://movingcostlab.com/ai/
- Search: GET https://movingcostlab.com/api/agent/search?q=<words>
- Read a page: GET https://movingcostlab.com/api/agent/article?slug=<slug>
- MCP: POST https://movingcostlab.com/mcp (tools/list, tools/call)
- Skill: https://movingcostlab.com/ai/skills/site-lookup/SKILL.md
- API catalog: https://movingcostlab.com/.well-known/api-catalog
- OpenAPI: https://movingcostlab.com/openapi.json

::ILANG::v5.0
::STATE{@ROLE, function:Use only the public read-only service above}
::MODULE{AGENT_INSTRUCTIONS}
  [MUST] Do not attempt agent-auth operations while available=false.
  [MUST] Preserve page identifiers, qualifiers and Updated dates; cite the source page URL.
  [MUST] Answer in the visitor's language; unknown facts remain unknown.
