# Auth.md: etom148.com

How AI agents authenticate with איטום 148, an Israeli roof waterproofing service.

## Audience

AI agents and assistants helping a person who has a roof waterproofing question, wants a quote, or wants to know whether the business serves their city.

## Summary

- Every agent endpoint here is **public and read-only**. No API key, token or registration is required.
- Agents cannot book jobs or send messages. The only write action is the lead form (`POST /api/lead`), which must be used only with the user's explicit consent and real details.

## Registration (optional, anonymous)

- Method: `anonymous`
- Register: `POST https://etom148.com/agent/identity` returns an `agent_id` with credential type `none`. Nothing is stored.
- Token: `POST https://etom148.com/oauth/token` with `grant_type=client_credentials` returns a short-lived bearer token with scope `public:read`. It is accepted but never required.
- Claim: `https://etom148.com/agent/identity/claim`: anonymous identities hold no data, so there is nothing to claim.

## Public endpoints

- REST (versioned): `https://etom148.com/api/v1/articles`, `https://etom148.com/api/v1/topics`, `https://etom148.com/api/v1/areas`, `https://etom148.com/api/v1/contact` (OpenAPI: https://etom148.com/openapi.json)
- MCP (Streamable HTTP, JSON-RPC): `https://etom148.com/mcp`, server card `https://etom148.com/.well-known/mcp/server-card.json`
- A2A: `https://etom148.com/a2a`, agent card `https://etom148.com/.well-known/agent-card.json`
- Markdown: append `.md` to any page or send `Accept: text/markdown`; index at https://etom148.com/llms.txt

## Metadata

- Protected resource metadata: https://etom148.com/.well-known/oauth-protected-resource
- Authorization server metadata: https://etom148.com/.well-known/oauth-authorization-server
- Agent catalog: https://etom148.com/.well-known/ai-catalog.json

```json
{
  "agent_auth": {
    "skill": "https://etom148.com/auth.md",
    "register_uri": "https://etom148.com/agent/identity",
    "claim_uri": "https://etom148.com/agent/identity/claim",
    "identity_types_supported": [
      "anonymous"
    ],
    "anonymous": {
      "credential_types_supported": [
        "none"
      ],
      "claim_uri": "https://etom148.com/agent/identity/claim"
    }
  }
}
```

## Rate limits and conduct

60 requests per minute per IP (RateLimit-* headers). Identify your agent in the User-Agent header. Contact: 072-3317667.
