# auth.md

conversion.stevebaka.de stellt oeffentliche Lese-Endpunkte fuer Agenten ohne Login bereit. Geschuetzte Schreib- oder Ingest-Endpunkte werden ueber die unten veroeffentlichten OAuth-Discovery-Dokumente beschrieben.

## Public endpoints

- /llms.txt
- /llms.json
- /skill.md
- /.well-known/agent-skill.md
- /.well-known/agent-skills/index.json
- /.well-known/api-catalog
- /.well-known/openapi.json
- /.well-known/mcp/server-card.json
- /api/markdown/
- /api/graphrag/
- /api/audit/
- /api/audit/stream/
- /mcp/
- /datasets

## OAuth discovery

- Authorization server metadata: https://conversion.stevebaka.de/.well-known/oauth-authorization-server
- OpenID configuration alias: https://conversion.stevebaka.de/.well-known/openid-configuration
- Protected resource metadata: https://conversion.stevebaka.de/.well-known/oauth-protected-resource
- JWKS: https://conversion.stevebaka.de/.well-known/jwks.json

## Agent registration

- Register URI: https://conversion.stevebaka.de/agent/auth/register
- Supported identity types: web, agent
- Supported credential types: bearer
- Scopes: read:knowledge, read:datasets
- Bearer method: header

## Protected resource

```json
{
  "resource": "https://conversion.stevebaka.de",
  "authorization_servers": [
    "https://conversion.stevebaka.de"
  ],
  "bearer_methods_supported": [
    "header"
  ],
  "scopes_supported": [
    "read:knowledge",
    "read:datasets"
  ]
}
```

## Authorization server

```json
{
  "issuer": "https://conversion.stevebaka.de",
  "authorization_endpoint": "https://conversion.stevebaka.de/agent/auth/authorize",
  "token_endpoint": "https://conversion.stevebaka.de/agent/auth/token",
  "registration_endpoint": "https://conversion.stevebaka.de/agent/auth/register",
  "revocation_endpoint": "https://conversion.stevebaka.de/agent/auth/revoke",
  "response_types_supported": [
    "code"
  ],
  "grant_types_supported": [
    "authorization_code"
  ],
  "code_challenge_methods_supported": [
    "S256"
  ],
  "scopes_supported": [
    "read:knowledge",
    "read:datasets"
  ],
  "agent_auth": {
    "documentation_url": "https://conversion.stevebaka.de/auth.md",
    "register_uri": "https://conversion.stevebaka.de/agent/auth/register",
    "registration_endpoint": "https://conversion.stevebaka.de/agent/auth/register",
    "token_endpoint": "https://conversion.stevebaka.de/agent/auth/token",
    "identity_types_supported": [
      "web",
      "agent"
    ],
    "credential_types_supported": [
      "bearer"
    ]
  }
}
```

## MCP

Der MCP-Endpunkt https://conversion.stevebaka.de/mcp/ ist ein oeffentlicher JSON-RPC-Endpunkt fuer Lesezugriff auf conversion.stevebaka.de. Er bietet Tools fuer GraphRAG-Suche, Markdown-Seiten und Datasets sowie Ressourcen fuer llms.txt, llms.json, skill.md und Dataset-Indizes.

## Usage

Die Inhalte duerfen fuer Suche, AI Input und zitierende Agenten genutzt werden, sofern conversion.stevebaka.de als Quelle genannt wird und Aussagen nicht aus dem Kontext geloest werden.