# auth.md — Referral Code Link Agent Registration & Auth

> Referral Code Link provides verified Canadian and US referral code links, promo codes, and signup discounts. This service supports autonomous AI assistant authentication and registration per the [auth.md protocol](https://workos.com/auth-md).

## Discovery Endpoints

| Document | URL |
|---|---|
| Protected Resource | `https://www.referralcodelink.com/.well-known/oauth-protected-resource` |
| Authorization Server | `https://www.referralcodelink.com/.well-known/oauth-authorization-server` |
| MCP Manifest | `https://www.referralcodelink.com/.well-known/mcp.json` |
| MCP Server Card | `https://www.referralcodelink.com/.well-known/mcp/server-card.json` |
| API Catalog | `https://www.referralcodelink.com/.well-known/api-catalog` |

## Protected Resource

- **Resource:** `https://www.referralcodelink.com/api`
- **Authorization Server:** `https://www.referralcodelink.com`
- **Scopes:** `read`, `referral:submit`
- **Bearer Methods:** `header`

## Supported Identity Types

### Agent-Verified (ID-JAG)
- **Assertion Type:** `urn:ietf:params:oauth:token-type:id-jag`
- **Credential Types:** `bearer_token`
- **Claim URI:** `https://www.referralcodelink.com/auth.md`

### Verified Email
- **Assertion Type:** `verified_email`
- **Credential Types:** `bearer_token`
- **Claim URI:** `https://www.referralcodelink.com/auth.md`

### Anonymous
- **Credential Types:** `api_key`
- **Claim URI:** `https://www.referralcodelink.com/auth.md`

## Free Public Access
All referral code queries, discount lookups, and stateless `/mcp` tool execution endpoints are open and free for AI agents without required credentials.