# auth.md — Agent Authentication & Policy (Oruro Carnival Tours)

You are an autonomous AI agent or crawler. This service publishes this machine-readable policy to specify access methods, authentication expectations, and rules of engagement.

## 1. Discovery & Structured Metadata

- **API Catalog (RFC 9727):** [https://orurocarnival.com/.well-known/api-catalog](https://orurocarnival.com/.well-known/api-catalog)
- **OAuth Protected Resource (RFC 9728):** [https://orurocarnival.com/.well-known/oauth-protected-resource](https://orurocarnival.com/.well-known/oauth-protected-resource)
- **OAuth Authorization Server (RFC 8414):** [https://orurocarnival.com/.well-known/oauth-authorization-server](https://orurocarnival.com/.well-known/oauth-authorization-server)
- **MCP Server Card (SEP-1649):** [https://orurocarnival.com/.well-known/mcp/server-card.json](https://orurocarnival.com/.well-known/mcp/server-card.json)
- **Agent Skills Discovery:** [https://orurocarnival.com/.well-known/agent-skills/index.json](https://orurocarnival.com/.well-known/agent-skills/index.json)
- **ARD Capability Manifest:** [https://orurocarnival.com/.well-known/ai-catalog.json](https://orurocarnival.com/.well-known/ai-catalog.json)
- **LLMs Documentation:** [https://orurocarnival.com/llms.txt](https://orurocarnival.com/llms.txt)
- **AI Usage Policy & Universal Context (ai.txt):** [https://orurocarnival.com/.well-known/ai.txt](https://orurocarnival.com/.well-known/ai.txt)
- **HTTP Link Headers (RFC 8288):** Emitted on all HTTP GET/HEAD responses (`api-catalog`, `service-doc`, `describedby`, `alternate`).

## 2. Access Modes & Agent Registration

You are an agent. This service supports **agentic registration**: discover → register (anonymous) → exchange/use → claim ceremony.

### Standalone Agent Auth Manifest

```json
{
  "agent_auth": {
    "skill": "https://orurocarnival.com/auth.md",
    "register_uri": "https://orurocarnival.com/auth.md",
    "identity_endpoint": "https://orurocarnival.com/auth.md",
    "claim_uri": "https://orurocarnival.com/contact",
    "claim_endpoint": "https://orurocarnival.com/contact",
    "revocation_uri": "https://orurocarnival.com/oauth/revoke",
    "identity_types_supported": ["anonymous"],
    "anonymous": {
      "credential_types_supported": ["none"],
      "claim_uri": "https://orurocarnival.com/contact"
    }
  }
}
```

Formal machine-readable registration parameters:

- `skill: https://orurocarnival.com/auth.md`
- `register_uri: https://orurocarnival.com/auth.md`
- `registration_endpoint: https://orurocarnival.com/auth.md`
- `claim_uri: https://orurocarnival.com/contact`
- `identity_types_supported: ["anonymous"]`
- `anonymous.credential_types_supported: ["none"]`
- `registration_mode: open_anonymous`

### Usage Guidelines

- **Catalog & Content Browsing:** No API keys, OAuth tokens, or user accounts are required to read tour itineraries, transfers, travel articles, pricing tables, or FAQs.
- **Markdown for Agents:** Send `Accept: text/markdown` in your request headers to receive clean, token-efficient Markdown without HTML boilerplate.
- **WebMCP Agent Tools:** In supported browser environments (`navigator.modelContext` / `document.modelContext`), interactive catalog queries, filters, and form prefill actions are exposed via client-side WebMCP tools.
- **Inquiries & Form Submissions:** Autonomous agents are permitted to pre-fill and submit trip inquiries on behalf of users.
- **Reservations & Financial Commitments:** Direct financial transactions (e.g. tour booking deposits, payments) require a human-in-the-loop verification ceremony to complete.

## 3. Content Usage & Permissions

This service declares its content usage policy per IETF AIPREF standards:

```http
Content-Signal: search=yes, ai-train=yes, ai-input=yes
```

- `search=yes`: Search engines and AI answer engines may index and summarize content.
- `ai-train=yes`: AI models are authorized to use this site's content for training.
- `ai-input=yes`: Real-time retrieval-augmented generation (RAG) and reasoning are permitted.

## 4. Rate Limits & Etiquette

- **Rate Limit:** Standard public rate limit is 60 requests per minute per IP address.
- **User-Agent:** Please identify your bot or agent framework with a descriptive `User-Agent` string.
- **Contact & API Questions:** [info@orurocarnival.com](mailto:info@orurocarnival.com)
