# Auth.md — Agent Registration for The Color Shop

## Overview
The Color Shop is a paint, hardware, and home improvement eCommerce platform
serving Apia, Samoa. AI agents can interact with our platform through the
endpoints described below.

## Agent Registration
1. Create an account at https://thecolorshop.ws/signup/
2. Verify your email address
3. Use OAuth 2.0 Authorization Code flow to obtain access tokens

## OAuth Endpoints
- **Issuer**: https://thecolorshop.ws/
- **Authorization**: https://thecolorshop.ws/accounts/login/
- **Token**: https://thecolorshop.ws/accounts/token/
- **OAuth Metadata**: https://thecolorshop.ws/.well-known/oauth-authorization-server
- **Protected Resource Metadata**: https://thecolorshop.ws/.well-known/oauth-protected-resource

## API Access
- **API Catalog**: https://thecolorshop.ws/.well-known/api-catalog
- **MCP Server Card**: https://thecolorshop.ws/.well-known/mcp/server-card.json
- **Agent Skills**: https://thecolorshop.ws/.well-known/agent-skills/index.json

## Scopes
- `read:products` — Browse product catalog
- `read:orders` — View order history
- `write:orders` — Create new orders
- `read:account` — View account details
- `write:account` — Update account details

## Rate Limits
API requests are subject to rate limiting. See response headers for
`X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `Retry-After`.

## Contact
For agent integration support, contact us at customer@thecolorshop.ws.