---
title: "Agent Docs"
description: "How AI agents use janlinketscher.com: MCP server (incl. booking a call), Markdown versions, llms.txt, feeds and structured data. Site content is in German."
language: en
url: https://janlinketscher.com/agent
---

# This site is built for agents.

Every page is also available as plain Markdown – append .md or send Accept: text/markdown to the canonical URL. An MCP server answers questions about Jan Linketscher and his essays directly and books calls with him. Every page carries schema.org structured data. The content itself is in German.

## Quick start

```
# Overview as Markdown
curl https://janlinketscher.com/llms.txt

# Any page as Markdown – via Accept header
curl -H "Accept: text/markdown" https://janlinketscher.com/agent

# MCP server: list tools
curl -X POST https://janlinketscher.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## MCP server

Streamable HTTP, no authentication. Speaks MCP 2026-07-28 (stateless, server/discover) and the earlier versions with initialize handshake back to 2024-11-05. Tools return text plus structured content (outputSchema); profile, pages and essays are also exposed as resources. All tools are read-only except book_meeting, which creates a booking via Cal.com. Clients that declare elicitation (2026-07-28, multi round-trip) get a confirmation form for the user from the server itself; other clients must get the user’s explicit approval and pass confirmed: true. The confirmation email goes to the attendee. Add it as a connector in Claude, ChatGPT or any other MCP client using the URL below.

| Path | Type | Description |
| --- | --- | --- |
| `/api/mcp` | MCP | Server endpoint (POST, JSON-RPC 2.0). |
| [/.well-known/mcp-server-card](https://janlinketscher.com/.well-known/mcp-server-card) | JSON | Server Card (SEP-2127 draft): identity, transport, protocol versions. |
| [com.janlinketscher/site](https://registry.modelcontextprotocol.io/v0/servers?search=com.janlinketscher) | Registry | Listed in the official MCP Registry. |
| [/.well-known/mcp.json](https://janlinketscher.com/.well-known/mcp.json) | JSON | Server description incl. tools, for registries and clients. |
| `get_profile` | Tool | Role at i22, background, how the texts are written, contact. Optional section: role, background, writing, contact. |
| `list_essays` | Tool | Essays, newest first. Optional topic (slug) and limit. |
| `get_essay` | Tool | Full text of one essay as Markdown, by slug. |
| `search` | Tool | Full-text search across essays and pages, with snippet and URL. German queries work best. |
| `list_meeting_types` | Tool | Kinds of calls: kennenlernen (30 min), sparring (60 min), with purpose and booking link. |
| `get_availability` | Tool | Free slots for a meeting type; optional from/to (YYYY-MM-DD), default the next 14 days. |
| `book_meeting` | Tool | Books a slot for the user (name, email, optional notes). With elicitation the server asks the user to confirm; otherwise confirmed: true after explicit approval. |

```
{
  "mcpServers": {
    "janlinketscher": { "url": "https://janlinketscher.com/api/mcp" }
  }
}
```

## Discovery files

| Path | Type | Description |
| --- | --- | --- |
| [/llms.txt](https://janlinketscher.com/llms.txt) | TEXT | Overview: who, what for, all pages and essays with links to their Markdown versions. |
| [/llms-full.txt](https://janlinketscher.com/llms-full.txt) | TEXT | All content in one file. |
| [/<page>.md](https://janlinketscher.com/about.md) | MD | Every page as Markdown, e.g. /about.md or /kontext.md. |
| `/essays/<slug>.md` | MD | Every essay as Markdown with front matter. |
| [/kontext](https://janlinketscher.com/kontext) | HTML | Grounding page: key facts about the person in one place. |
| [/agent.md](https://janlinketscher.com/agent.md) | MD | This page as Markdown. |
| [/api/agent.json](https://janlinketscher.com/api/agent.json) | JSON | Data behind the MCP server: profile, topics, essays, pages. |
| [/rss.xml](https://janlinketscher.com/rss.xml) | RSS | Essay feed. |
| [/feed.json](https://janlinketscher.com/feed.json) | JSON | Essay feed (JSON Feed 1.1). |
| [/sitemap-index.xml](https://janlinketscher.com/sitemap-index.xml) | XML | Sitemap. |
| [/robots.txt](https://janlinketscher.com/robots.txt) | TEXT | All AI crawlers explicitly allowed. |

## Structured data

Every page includes JSON-LD (schema.org): Person (employer i22, portrait, LinkedIn), WebSite, the essay series as CreativeWorkSeries, each essay as Article.

## Contact

- **Name:** Jan Linketscher
- **Email:** [mail@janlinketscher.com](mailto:mail@janlinketscher.com)
- **LinkedIn:** [linkedin.com/in/janlinketscher](https://www.linkedin.com/in/janlinketscher/)
- **Book a call:** [Kennenlernen (30 min) or Sparring (60 min) – menu → Kontakt, or MCP book_meeting](https://janlinketscher.com/#kontakt)
- **Employer:** [i22 Digitalagentur GmbH, Bonn](https://i22.ai)

## Guidelines

- **Citation:** Welcome – please cite with name and URL.
- **Language:** Site content is German; these docs are English.
- **Authorship:** Thoughts, experience and judgement are Jan Linketscher’s own; the texts are written with AI and every line is reviewed and owned by him.