For AI agents

ksebe.sk exposes structured data and tools for AI agents. This page shows how to wire them up in under 5 minutes.

Discovery

/llms.txt — site overview, entry points, language coverage.
/.well-known/agent-skills/index.json — RFC v0.2.0 skills discovery.
/.well-known/mcp/server-card.json — SEP-1649 MCP server card.
/.well-known/api-catalog — RFC 9727 linkset pointing at the OpenAPI spec.
https://mcp-server-alpha.vercel.app/openapi.json — OpenAPI 3 spec for the full REST surface.

Markdown for any page

Any HTML page on this site responds to Accept: text/markdown with the same content in markdown form (content-type text/markdown). Example:

Shellbash

curl -H 'Accept: text/markdown' https://www.ksebe.sk/blog

Claude Desktop

Paste into your claude_desktop_config.json:

claude_desktop_config.jsonjson

{
  "mcpServers": {
    "ksebe-booking": {
      "url": "https://mcp-server-alpha.vercel.app/mcp"
    }
  }
}

ChatGPT (GPT Action)

Setup notesyaml

# ChatGPT GPT Action — point at the OpenAPI spec.
# 1) In the GPT builder, add an Action.
# 2) Import from URL: https://mcp-server-alpha.vercel.app/openapi.json
# 3) Authentication: None (anon) or API Key (Bearer) for partner tools.
# 4) Set x-openai-isConsequential: false on read-only operations.

Pipedream

Published components live under @pipedream/ksebe. See pipedream.com/apps and search for “ksebe.sk”.

curl quickstart

Shellbash

# Anon tier — read only. No Bearer token needed.
curl 'https://mcp-server-alpha.vercel.app/mcp/list-therapists?filters%5Btopic%5D=anxiety&limit=20' \
  -H 'Accept: application/json'

# Partner tier — contact ksebe.sk for an API key.
curl 'https://mcp-server-alpha.vercel.app/mcp/book-session' \
  -H 'Authorization: Bearer <your_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"therapist_id":"...","slot_start":"2026-05-01T10:00:00Z","session_type":"online"}'

Auth tiers

Tier	Auth	Tools	Limits
Anon	none	`list-therapists` (topic filter required), `get-available-slots`, `get-session-types`	30/min per IP
Partner	`Authorization: Bearer <key>`	All 9 tools (list + book/cancel/reschedule + coupon)	30/min read, 5/min mutation, 3/min book

For a partner key, email hello@ksebe.sk.

Rate-limit and error behavior

400 topic_filter_required — anon list-therapists without filters.topic. The response hint field points at /llms/topics/index.md.
402 partner_required — anon pagination attempt.
429 rate_limited — includes a Retry-After header.
503 upstream_timeout — transient; retry with backoff.