# Auth.md — mishkan-hatchelet.co.il

How AI agents authenticate with Mishkan HaTchelet (משכן התכלת), an Israeli Judaica store.

## Audience

AI agents and assistants acting for shoppers who want to search the catalog, compare products, check prices and stock, or read store policies.

## Summary

- All agent-facing endpoints are **public and read-only**. No API key, OAuth token or registration is required to use them.
- Agents cannot place orders, manage carts, sign in to customer accounts or handle payments. Send the shopper to the product URL to buy.

## Registration (optional, anonymous)

- Method: `anonymous`
- Register: `POST https://mishkan-hatchelet.co.il/agent/identity` → returns an `agent_id` with credential type `none` and scope `catalog:read`. Nothing is stored.
- Claim: `https://mishkan-hatchelet.co.il/agent/identity/claim` → anonymous identities hold no data, so there is nothing to claim; people create accounts at https://mishkan-hatchelet.co.il/my-account/.

## Credentials

None. Do not send an `Authorization` header to the public endpoints. The OAuth 2.1 server listed in the metadata below belongs to the site's administrative MCP integration (scope `mcp`) and is for site administrators only.

## Public endpoints

- MCP (Streamable HTTP, JSON-RPC): `https://mishkan-hatchelet.co.il/mcp` — server card `https://mishkan-hatchelet.co.il/.well-known/mcp/server-card.json`
- A2A: `https://mishkan-hatchelet.co.il/a2a` — agent card `https://mishkan-hatchelet.co.il/.well-known/agent-card.json`
- OpenAPI: `https://mishkan-hatchelet.co.il/openapi.json` (WooCommerce Store API, read-only)
- NLWeb-style search: `https://mishkan-hatchelet.co.il/ask?query=...`
- Markdown: any page with `Accept: text/markdown`, plus `https://mishkan-hatchelet.co.il/llms.txt`

## Metadata

- Protected resource metadata: https://mishkan-hatchelet.co.il/.well-known/oauth-protected-resource
- Authorization server metadata: https://mishkan-hatchelet.co.il/.well-known/oauth-authorization-server
- Agent catalog: https://mishkan-hatchelet.co.il/.well-known/ai-catalog.json

```json
{
    "agent_auth": {
        "skill": "https://mishkan-hatchelet.co.il/auth.md",
        "register_uri": "https://mishkan-hatchelet.co.il/agent/identity",
        "claim_uri": "https://mishkan-hatchelet.co.il/agent/identity/claim",
        "identity_types_supported": [
            "anonymous"
        ],
        "anonymous": {
            "credential_types_supported": [
                "none"
            ],
            "claim_uri": "https://mishkan-hatchelet.co.il/agent/identity/claim"
        }
    }
}
```

## Rate limits and conduct

Be gentle: at most about 1 request per second. Identify your agent in the User-Agent header. Contact: meni@mishkan100.co.il, 1-800-707-707.
