# kosename.me — Entwickler & Agenten

> Integration für AI-Agenten, MCP-Clients, NLWeb-Konsumenten und ChatGPT-Plugins.

## MCP

- Server URL: `https://www.kosename.me/mcp` (transport: streamable-http)
- Server-Card: https://www.kosename.me/.well-known/mcp/server-card.json
- Tools: `list_names`, `get_name`, `list_categories`, `search`
- Resources: `kosename://names`, `kosename://categories`, llms-full.txt
- Prompts: `find_kosename`

### Quickstart: Claude Desktop / Cursor

```json
{
  "mcpServers": {
    "kosename-me": {
      "transport": { "type": "http", "url": "https://www.kosename.me/mcp" }
    }
  }
}
```

### Probe (curl)

```bash
curl -s https://www.kosename.me/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## NLWeb

- Endpoint: `POST https://www.kosename.me/ask`. JSON body `{"query": "..."}`. SSE via header `Prefer: streaming=true`.
- Spec: NLWeb (Microsoft).

## ChatGPT / Function Calling

- OpenAPI 3.1: https://www.kosename.me/openapi.json — import direkt in Custom GPT Actions oder OpenAI Function Calling.
- Operation IDs sind eindeutig (`listNames`, `getName`, `listCategories`, `searchNames`, `nlwebAsk`).

## Signed Bots (Web Bot Auth, RFC 9421)

- Public-Key-Directory: https://www.kosename.me/.well-known/http-message-signatures-directory
- Bei höherem Volumen bitte vorher signierten Bot bei ai@kosename.me registrieren.

## Webhooks

- Subscription-Endpoint (beta): `POST https://www.kosename.me/webhooks` — siehe https://www.kosename.me/developers#webhooks
- Events: `entry.published`, `entry.updated`, `category.updated`.
- Payload: JSON, signiert mit HMAC-SHA-256 (Header `X-Kosename-Signature`).