# Agent Authentication & Registration — muratakar.com

This document describes how AI agents can register, authenticate, and interact with the muratakar.com portfolio site.

## Public Access (No Authentication Required)

The following resources are publicly accessible without any authentication:

- **Profile & Context:** `GET https://muratakar.com/llms.txt` — Machine-readable profile for AI models
- **Portfolio Content:** `GET https://muratakar.com/` with `Accept: text/markdown` header — Markdown-formatted portfolio
- **MCP Server Card:** `GET https://muratakar.com/.well-known/mcp/server-card.json` — MCP capabilities
- **Agent Skills:** `GET https://muratakar.com/.well-known/agent-skills/index.json` — Available skills
- **API Catalog:** `GET https://muratakar.com/.well-known/api-catalog` — API discovery

## Agent Identity Registration

Agents wishing to identify themselves may do so via the following methods:

### Option 1: User-Agent Header
Include a descriptive `User-Agent` header identifying your agent:
```
User-Agent: MyAgent/1.0 (agent-type/research; contact/agent@example.com)
```

### Option 2: HTTP Message Signatures (Recommended)
Use HTTP Message Signatures (RFC 9421) for cryptographically verified bot identity. Key discovery:
```
GET /.well-known/http-message-signatures-directory
```

## OAuth / OIDC Discovery

For agents requiring authenticated access to protected resources:

- **OAuth Authorization Server:** `https://muratakar.com/.well-known/oauth-authorization-server`
- **OpenID Configuration:** `https://muratakar.com/.well-known/openid-configuration`
- **Protected Resource Metadata:** `https://muratakar.com/.well-known/oauth-protected-resource`

## Content Signals

This site declares the following content usage preferences:

- `ai-train=no` — Content may **not** be used for AI model training
- `search=yes` — Content **may** be indexed for search
- `ai-input=yes` — Content **may** be used as agent context/input

## Contact

For agent-specific integration queries: **info@muratakar.com**

Portfolio: [https://muratakar.com](https://muratakar.com)