Agent Docs

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.

/api/mcpMCPServer endpoint (POST, JSON-RPC 2.0).
/.well-known/mcp-server-cardJSONServer Card (SEP-2127 draft): identity, transport, protocol versions.
com.janlinketscher/siteRegistryListed in the official MCP Registry.
/.well-known/mcp.jsonJSONServer description incl. tools, for registries and clients.
get_profileToolRole at i22, background, how the texts are written, contact. Optional section: role, background, writing, contact.
list_essaysToolEssays, newest first. Optional topic (slug) and limit.
get_essayToolFull text of one essay as Markdown, by slug.
searchToolFull-text search across essays and pages, with snippet and URL. German queries work best.
list_meeting_typesToolKinds of calls: kennenlernen (30 min), sparring (60 min), with purpose and booking link.
get_availabilityToolFree slots for a meeting type; optional from/to (YYYY-MM-DD), default the next 14 days.
book_meetingToolBooks 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

/llms.txtTEXTOverview: who, what for, all pages and essays with links to their Markdown versions.
/agent.mdMDThis page as Markdown.
/api/agent.jsonJSONData behind the MCP server: profile, topics, essays, pages.
/sitemap-index.xmlXMLSitemap.
/robots.txtTEXTAll 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
LinkedIn: linkedin.com/in/janlinketscher
Book a call: Kennenlernen (30 min) or Sparring (60 min) – menu → Kontakt, or MCP book_meeting
Employer: i22 Digitalagentur GmbH, Bonn

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.