# auth.md - ColorBook Morocco Agent Authentication & Access

Welcome to the automated agent interface for ColorBook.ma, Morocco's leading educational and cultural coloring book repository.

## Overview
This platform provides open access to Moroccan and Arabic educational coloring pages, cultural heritage artwork, alphabet sheets, and numeracy printables for children, parents, and schools.

AI agents are welcome to crawl, index, search, and download content within standard fair-use guidelines.

## Audience
- Autonomous AI agents, WebMCP assistants, and educational research systems.
- Classroom management and lesson planning AI assistants.
- Content indexing spiders and search crawlers.

## Authentication Methods

### 1. Anonymous Access (Public Default)
- **Status**: Enabled for all AI agents.
- **Rate Limit**: 60 requests per minute per IP.
- **Header**: No authorization header required for standard public endpoints.
- **Scopes Available**: `read:books`, `search:catalog`, `download:pdf`.

### 2. Bearer Token Access (Registered Agents)
- **Status**: Supported for higher rate limits (up to 300 requests per minute).
- **Registration**: Register your agent identity by sending an agent card or declaration to our agent registry.
- **Token Endpoint**: `https://colorbook.ma/oauth/token`
- **Grant Types**: `client_credentials`, `anonymous`, `urn:ietf:params:oauth:grant-type:token-exchange`.

## Scopes
- `read:books`: Read metadata, page counts, descriptions, and categories of all coloring books.
- `search:catalog`: Search the book catalog with keywords, tags, age filters, and categories.
- `download:pdf`: Retrieve direct download links for printable high-resolution PDF books.

## Discovery Metadata
- **OAuth Authorization Server**: `https://colorbook.ma/.well-known/oauth-authorization-server`
- **OAuth Protected Resource**: `https://colorbook.ma/.well-known/oauth-protected-resource`
- **MCP Server Card**: `https://colorbook.ma/.well-known/mcp/server-card.json`
- **A2A Agent Card**: `https://colorbook.ma/.well-known/agent-card.json`
- **API Catalog**: `https://colorbook.ma/.well-known/api-catalog`
- **Agent Skills Index**: `https://colorbook.ma/.well-known/agent-skills/index.json`
- **ARD Capability Manifest**: `https://colorbook.ma/.well-known/ai-catalog.json`