Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Ktemia

von KtemiaaVersion 0.1.5i★ 2iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.Ktemiaa/ktemia-mcp

So installierst du es

What it does

Search and compare flights, hotels and rental cars, with each seller's price and booking link.

  • Connects Computer oder Cloud
  • Account or key Cloud: Needs X-API-Key · Local: Needs KTEMIA_API_KEY
  • Category Reisen, Karten & Wetter

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit19/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert39/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: 25 (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Ktemia. Folge https://mcp.popnx.com/i/ktemiaa-ktemia-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.ktemia.com) · ✓ Befehle geprüft am 19. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 5 Min.

Du brauchst einen Schlüssel von Ktemia (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei Ktemia registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Ktemia öffnen ↗

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameKtemia
    Remote MCP server URL · Adressehttps://mcp.ktemia.com/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameX-API-Key
    Wert<Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

    +ConnectorsKtemia

  5. Ausprobieren

    Nutze Ktemia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Ktemia nutzt, oder ein Werkzeug von Ktemia in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Ktemia noch nicht verbinden

Ktemia braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die Ktemia verbinden kann

  • Du brauchst einen Schlüssel von Ktemia (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von Ktemia (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Ktemia (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von Ktemia (auf der Seite des Anbieters erstellen)

B · Andere in Reisen, Karten & Wetter, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code · etwa 5 Min.

Du brauchst einen Schlüssel von Ktemia (auf der Seite des Anbieters erstellen)

  1. Bei Ktemia registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Ktemia öffnen ↗

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user ktemia https://mcp.ktemia.com/mcp --header 'X-API-Key: your-value'

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    Ktemia sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze Ktemia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Ktemia nutzt, oder ein Werkzeug von Ktemia in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 5 Min.

Du brauchst einen Schlüssel von Ktemia (auf der Seite des Anbieters erstellen)

  1. Bei Ktemia registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Ktemia öffnen ↗

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Ktemia ist X-API-Key leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Ktemia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Ktemia nutzt, oder ein Werkzeug von Ktemia in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 5 Min.

Du brauchst einen Schlüssel von Ktemia (auf der Seite des Anbieters erstellen)

  1. Bei Ktemia registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Ktemia öffnen ↗

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von Ktemia ist X-API-Key leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze Ktemia und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Ktemia nutzt, oder ein Werkzeug von Ktemia in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.ktemia.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Ktemia nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user ktemia https://mcp.ktemia.com/mcp --header 'X-API-Key: your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ktemia": {
      "url": "https://mcp.ktemia.com/mcp",
      "headers": {
        "X-API-Key": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ktemia": {
      "type": "http",
      "url": "https://mcp.ktemia.com/mcp",
      "headers": {
        "X-API-Key": "your-value"
      }
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user ktemia --env KTEMIA_API_KEY=your-value -- npx -y @ktemia/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ktemia": {
      "command": "npx",
      "args": [
        "-y",
        "@ktemia/mcp"
      ],
      "env": {
        "KTEMIA_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ktemia": {
      "command": "npx",
      "args": [
        "-y",
        "@ktemia/mcp"
      ],
      "env": {
        "KTEMIA_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ktemia": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ktemia/mcp"
      ],
      "env": {
        "KTEMIA_API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • KTEMIA_API_KEY geheim erforderlich env
    Dein Ktemia-API-Schlüssel. Einen kostenlosen erhältst du unter https://app.ktemia.com/api-keys
    Englisches Original anzeigenYour Ktemia API key. Get a free one at https://app.ktemia.com/api-keys
  • X-API-Key geheim erforderlich HTTP header
    Dein Ktemia-API-Schlüssel. Einen kostenlosen erhältst du unter https://app.ktemia.com/api-keys
    Englisches Original anzeigenYour Ktemia API key. Get a free one at https://app.ktemia.com/api-keys

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
546/Wo.
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.1.5
In der Registry veröffentlichti
19. Nov. 2026
Code zuletzt geänderti
19. Nov. 2026
Zuletzt geprüft
19. Nov. 2026
Entwickler
Ktemiaa
Pakete
npm: @ktemia/mcp
pypi: ktemia-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto Ktemiaa bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 253 ms (HTTP 401)

  • ✓ Bestanden

    Anmeldung mit OAuth

    Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/ktemiaa-ktemia-mcp.svg)](https://mcp.popnx.com/en/servers/ktemiaa-ktemia-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Reisen, Karten & Wetteri

  • Mehr Sterne als 92 % der anderen 2025 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 99 % der anderen 2025 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 2025 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Ktemia sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: X-API-Key, KTEMIA_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (0.1.5) kam gestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

von microWachsend★ 440Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ micro.mu

Award Travel Finder

Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.

von AwardTravelFinderAm Anfang★ 15Aktualisiert vor 3 Monaten

Läuft in der Cloud✓ vom Dienst · awardtravelfinder.com

Killbottleneck

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

von tengolabsAm Anfang↓ 328/Wo.★ 14Aktualisiert vor 13 Tagen

Läuft auf deinem Computer✓ vom Dienst · killbottleneck.com

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

von WhimsicalCodeAm Anfang★ 11Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · whimsical.com
Im Vergleich mit ähnlichen
Dieser
Ktemia
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinJa
Basisprüfungen5/54/43/33/34/44/4
LizenzMITAGPL-3.0MITMITMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Ktemia MCP server

A Model Context Protocol server that searches and compares flights, hotels, and rental cars with the Ktemia API. Point Cursor, Claude Code, Claude Desktop, Codex, or any MCP client at it, ask in plain language, and the agent looks up the place, runs the search, and returns each seller's price with a booking link.

Available for both Node (npx -y @ktemia/mcp) and Python (uvx ktemia-mcp).

[Get a free API key](https://app.ktemia.com/api-keys) · API reference · Getting started · Pricing · Guide: flights in Cursor and Claude · Changelog

Ktemia compares prices. It does not book the ticket, the car, or the room. The traveller books on the seller's site.

ToolUse it for
ktemia_key_statusPlan, rate limits, and requests left this month. Costs no quota.
ktemia_lookupAirport, airline, hotel, and car rental location codes
ktemia_search_flightsOne-way, round trip, and multi-city fares
ktemia_search_hotelsStays, with stars, ratings, and amenity filters
ktemia_search_carsA hire at a city or airport
ktemia_get_detailsEvery price and booking link for one chosen result
ktemia_get_hotel_reviewsGuest reviews for one hotel

Every plan can use the MCP server, including the Free plan with its 100 requests a month. A paid plan buys request volume and rate, not access.

Two packages, one behaviour

The server ships in both languages, so you can run it with whichever runtime your machine already has:

PackageCommandNeeds
Node@ktemia/mcpnpx -y @ktemia/mcpNode 20+
Pythonktemia-mcpuvx ktemia-mcpPython 3.10+ and uv

They are not two codebases that happen to agree. Both read one shared contract, spec/tools.json, for every tool name, description, enum, and limit, and CI fails if they drift. Same seven tools, same wording, same errors — pick either.

npx and uvx both fetch the package on first run and cache it, so there is nothing to install or upgrade by hand.

Install

You need an API key from app.ktemia.com/api-keys. Free, no card.

Each example below shows Node first, then Python. Use one, not both — two copies of the same server would just show every tool twice.

Cursor

Add to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):

{

"mcpServers": { "ktemia": { "command": "npx", "args": ["-y", "@ktemia/mcp"], "env": { "KTEMIA_API_KEY": "${env:KTEMIA_API_KEY}" } } } }

Python instead:

{

"mcpServers": { "ktemia": { "command": "uvx", "args": ["ktemia-mcp"], "env": { "KTEMIA_API_KEY": "${env:KTEMIA_API_KEY}" } } } }

${env:KTEMIA_API_KEY} reads the key from your shell environment, so the key itself is not committed in a project file. Export it in your shell profile:

export KTEMIA_API_KEY="your-key"

To paste the key directly instead, put it in ~/.cursor/mcp.json rather than a project file, and do not commit it.

Claude Code
claude mcp add ktemia -e KTEMIA_API_KEY=your-key -- npx -y @ktemia/mcp

Python instead:

claude mcp add ktemia -e KTEMIA_API_KEY=your-key -- uvx ktemia-mcp

Everything after -- is the command Claude Code runs. Check it with claude mcp list.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows:

{

"mcpServers": { "ktemia": { "command": "npx", "args": ["-y", "@ktemia/mcp"], "env": { "KTEMIA_API_KEY": "your-key" } } } }

Python instead: "command": "uvx", "args": ["ktemia-mcp"].

Restart Claude Desktop, then ask for a flight.

Claude Desktop launches servers from a GUI process that does not read your shell profile, so npx or uvx must be somewhere it can see. If the server fails to start, use the absolute path from which npx or which uvx as command.

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.ktemia]

command = "npx" args = ["-y", "@ktemia/mcp"] env = { KTEMIA_API_KEY = "your-key" }

Python instead:

[mcp_servers.ktemia]

command = "uvx" args = ["ktemia-mcp"] env = { KTEMIA_API_KEY = "your-key" }

Any other MCP client

The server speaks MCP over stdio. Run npx -y @ktemia/mcp or uvx ktemia-mcp with KTEMIA_API_KEY in the environment.

It negotiates the protocol revision per connection, so it answers both current (2026-07-28) clients and clients that still open with the older initialize handshake.

Check it before wiring it up

Run the command in a terminal first:

KTEMIA_API_KEY=your-key npx -y @ktemia/mcp     # or: uvx ktemia-mcp

It should sit silently waiting for JSON-RPC on stdin; Ctrl-C to quit. An immediate error means the environment is wrong, and reading it here is easier than digging through a client's logs.

Try it

Find flights from Lisbon to London on 15 March 2027.

I need a car at Austin airport from 10 to 17 March, automatic, and I am 23.

A hotel in London for two, 10–12 March, four stars or better, free cancellation if you can find it. Then show me recent reviews for the one I pick.

How many Ktemia requests do I have left this month?

How the search tools work

A search is two steps upstream, folded into one tool call:

  1. Call ktemia_search_flights (or hotels, or cars) with the trip details. You get the first page of results and a nextToken.
  2. Call the same tool again with only nextToken to get the next page. When nextToken is absent, that was the last page.

Tokens are opaque and expire one hour after the search starts. If a token expires, start a new search rather than retrying it.

Hotel and car searches need a location id from ktemia_lookup — the locationId field of a result, which is a numeric string like 29230, not a city name. Flight searches take IATA codes from the code field instead, such as LHR for Heathrow or LON for every London airport.

ktemia_get_details expands one result into every price and booking link. Search pages carry only the leading offers, so this is the call that answers "where do I actually book this".

Quota

Every tool call is one request against your plan's monthly quota, with one exception: ktemia_key_status is free and keeps answering after the quota is spent, which is how an agent diagnoses a QUOTA_EXCEEDED error without making it worse.

A search costs at least two requests — one to start it, one per page read — so budget accordingly. The quota is shared across every key on an account, so creating a second key does not raise the limit.

Two different errors both arrive as HTTP 429, and they mean opposite things:

CodeMeaningWhat to do
RATE_LIMIT_EXCEEDEDToo many requests per secondWait for Retry-After, then retry
QUOTA_EXCEEDEDThe month's allowance is goneStop. Retrying cannot help.

Limits per plan are on pricing.

Security

  • The key is read from KTEMIA_API_KEY and sent only as the X-API-Key header, over HTTPS, to https://api.ktemia.com.
  • The key is never a tool parameter. An agent should never ask you to paste it into a tool call, and the server never exposes it in a result.
  • A KTEMIA_API_URL override must be https:// (or localhost, for development), and redirects are refused, so the key cannot be sent to another host.
  • Upstream calls carry X-Ktemia-Client: mcp/ , so MCP traffic is distinguishable from direct API traffic in Ktemia's own logs.
  • Every tool is read-only. Nothing here books, pays, holds, or cancels anything.

Consider using a separate key for your editor, so you can revoke it without touching a production integration. The quota is per account, so a second key costs you nothing in allowance.

A note on the hosted server

A hosted server at mcp.ktemia.com is planned, and it will accept your API key and forward it to api.ktemia.com. The MCP security guidance names that shape "token passthrough" and advises against it, so it is worth being explicit about why it is acceptable here: the guidance targets OAuth audience confusion, where a server accepts a token minted for a different service and deceives a third-party resource server into trusting it. A Ktemia key is first-party, the MCP server is Ktemia, and the quota and rate limits live on that same key upstream — one audience, no third party, and no control bypassed. If that changes, OAuth 2.1 is the migration, and the credential source is a single seam in the code so it will not ripple into the tools.

Until then, run it locally over stdio as above.

Self-host and develop

git clone https://github.com/Ktemiaa/ktemia-mcp.git

cd ktemia-mcp

TypeScript

cd typescript

npm install npm run build npm test

Python

cd python

uv sync # also copies spec/tools.json into the package uv run pytest

Point your client at whichever you built:

{

"mcpServers": { "ktemia": { "command": "node", "args": ["/absolute/path/to/ktemia-mcp/typescript/dist/index.js"], "env": { "KTEMIA_API_KEY": "your-key" } } } }

For Python, "command": "uv" with "args": ["--directory", "/absolute/path/to/ktemia-mcp/python", "run", "ktemia-mcp"].

Layout
spec/tools.json   shared tool contract: names, descriptions, enums, defaults

typescript/ the npm package, @ktemia/mcp python/ the PyPI package, ktemia-mcp

Tool names, descriptions, enums, and defaults live in spec/tools.json, which both implementations read. The descriptions are what steer an agent — text like "a guessed city searches the wrong trip and spends quota" is what stops it inventing a departure airport — so they are written once rather than copied, since prose that drifts between two packages would change agent behaviour with nothing in any log to show why.

Each package copies that file in at build time, because neither npm nor a Python wheel can include a file from outside its own directory. typescript/scripts/sync-spec.mjs and python/hatch_build.py do that, and CI asserts both copies are byte-identical to the original.

Tests

TypeScript

npm test          # offline, deterministic, no key needed

npm run test:live # opt-in, spends real quota

Python

uv run pytest                      # offline; the live tests skip themselves

KTEMIA_API_KEY=your-key uv run pytest tests/test_live.py uv run python scripts/smoke_wheel.py # checks an installed build can start

The offline suites stub the transport, so they cover what production cannot reach on demand — a spent quota, a rate limit, a timeout, a malformed upstream body — and assert that a missing required field is refused locally without an upstream call, so a guessed search cannot cost you a request.

python/tests/test_parity.py is the one that keeps the packages honest: it asserts both register the same seven tools in the same order, that every description contains the shared spec's prose verbatim, that every metered tool says so and ktemia_key_status does not, and that no numeric parameter advertises an absurd bound.

The live suites run only

Nur der Anfang wird gezeigt; den Rest findest du im Repo