# auth.md

You are an agent. This file describes how AI agents may discover and register access to **Metkan Orman Urunleri** public tools and contact endpoints.

## auth.md Registration

Metkan public agent tools support anonymous access and optional OAuth `client_credentials` for Bearer tokens.

### Anonymous registration (public tools)

```yaml
identity_types_supported: ["anonymous"]
anonymous:
  credential_types_supported: ["none"]
  claim_uri: "https://metkanormanurunleri.com/api/health"
register_uri: "https://metkanormanurunleri.com/mcp"
registration_methods:
  - name: mcp_initialize
    method: POST
    uri: "https://metkanormanurunleri.com/mcp"
    content_type: application/json
    description: >
      Send JSON-RPC initialize, then tools/list / tools/call.
      No client_id, API key, or agent account is required.
  - name: contact_lead
    method: POST
    uri: "https://metkanormanurunleri.com/form/teklif.php"
    content_type: application/x-www-form-urlencoded
    description: >
      Provision a human follow-up pallet quote lead (name, phone, email, message).
  - name: oauth_client_credentials
    method: POST
    uri: "https://metkanormanurunleri.com/oauth/token"
    content_type: application/x-www-form-urlencoded
    description: >
      Optional Bearer for metkan.public.read. grant_type=client_credentials,
      token_endpoint_auth_method=none.
```

### agent_auth

```yaml
agent_auth:
  skill: "https://metkanormanurunleri.com/.well-known/agent-skills/metkan-contact/SKILL.md"
  register_uri: "https://metkanormanurunleri.com/oauth/register"
  methods:
    - mcp_initialize
    - contact_lead
    - oauth_client_credentials
```

## OAuth discovery

| Document | URL |
| --- | --- |
| Authorization Server (RFC 8414) | https://metkanormanurunleri.com/.well-known/oauth-authorization-server |
| OpenID configuration | https://metkanormanurunleri.com/.well-known/openid-configuration |
| Protected Resource (RFC 9728) | https://metkanormanurunleri.com/.well-known/oauth-protected-resource |
| JWKS | https://metkanormanurunleri.com/.well-known/jwks.json |
| Token | https://metkanormanurunleri.com/oauth/token |
| Register | https://metkanormanurunleri.com/oauth/register |

Scopes: `metkan.public.read`. Resource: `https://metkanormanurunleri.com`.

## Audience

- AI agents that need accurate Metkan wholesale EURO pallet facts for Izmir/Manisa
- Tools that want public MCP company/product/contact tools
- Humans requesting pallet quotes via the contact form

## Public discovery

| Resource | URL |
| --- | --- |
| llms.txt | https://metkanormanurunleri.com/llms.txt |
| MCP server card | https://metkanormanurunleri.com/.well-known/mcp/server-card.json |
| MCP endpoint | https://metkanormanurunleri.com/mcp |
| API catalog | https://metkanormanurunleri.com/.well-known/api-catalog |
| Agent skills | https://metkanormanurunleri.com/.well-known/agent-skills/index.json |
| Agent card | https://metkanormanurunleri.com/.well-known/agent-card.json |
| ARD catalog | https://metkanormanurunleri.com/.well-known/ai-catalog.json |
| Health | https://metkanormanurunleri.com/api/health |