Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Ktemia

de Ktemiaaversión 0.1.5i★ 2iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.Ktemiaa/ktemia-mcp

Cómo instalar

What it does

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

  • Connects Computadora o nube
  • Account or key Cloud: Needs X-API-Key · Local: Needs KTEMIA_API_KEY
  • Category Viajes, mapas y clima

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad19/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso39/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: 25 (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Ktemia. Sigue https://mcp.popnx.com/i/ktemiaa-ktemia-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (mcp.ktemia.com) · ✓ Comandos revisados el 19 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 5 min

Necesitas una clave de Ktemia (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Regístrate y crea una clave de Ktemia

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Ktemia ↗

  2. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreKtemia
    Remote MCP server URL · Direcciónhttps://mcp.ktemia.com/mcp

    En Request headers, añade este nombre y valor

    Nombre del headerX-API-Key
    Valor<pega tu clave aquí>

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  4. Actívalo en un chat

    +ConnectorsKtemia

  5. Pruébalo

    Usa Ktemia y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Ktemia o muestra una herramienta de Ktemia en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Ktemia

Ktemia necesita tu propia clave para conectarse, pero la ayuda de OpenAI solo describe el inicio de sesión con OAuth; no hay una opción de clave que hayamos podido verificar

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Ktemia

  • Necesitas una clave de Ktemia (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner
  • Necesitas una clave de Ktemia (créala en el sitio del autor)
  • Necesitas una clave de Ktemia (créala en el sitio del autor)
  • Necesitas una clave de Ktemia (créala en el sitio del autor)

B · Otros en Viajes, mapas y clima que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code · unos 5 min

Necesitas una clave de Ktemia (créala en el sitio del autor)

  1. Regístrate y crea una clave de Ktemia

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Ktemia ↗

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

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

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Escribe /mcp en Claude Code

    Deberías ver Ktemia en la lista como conectado

  5. Pruébalo

    Usa Ktemia y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Ktemia o muestra una herramienta de Ktemia en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 5 min

Necesitas una clave de Ktemia (créala en el sitio del autor)

  1. Regístrate y crea una clave de Ktemia

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Ktemia ↗

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de Ktemia, X-API-Key está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de Cursor en modo Agent

  5. Pruébalo

    Usa Ktemia y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Ktemia o muestra una herramienta de Ktemia en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 5 min

Necesitas una clave de Ktemia (créala en el sitio del autor)

  1. Regístrate y crea una clave de Ktemia

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Ktemia ↗

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de Ktemia, X-API-Key está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de VS Code en modo Agent

  5. Pruébalo

    Usa Ktemia y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Ktemia o muestra una herramienta de Ktemia en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://mcp.ktemia.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Ktemia💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la 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"
      }
    }
  }
}

Instalado en tu computadora

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"
      }
    }
  }
}

Valores que debes completar

  • KTEMIA_API_KEY secreto obligatorio env
    Tu clave de API de Ktemia. Obtén una gratis en https://app.ktemia.com/api-keys
    Ver original en inglésYour Ktemia API key. Get a free one at https://app.ktemia.com/api-keys
  • X-API-Key secreto obligatorio HTTP header
    Tu clave de API de Ktemia. Obtén una gratis en https://app.ktemia.com/api-keys
    Ver original en inglésYour Ktemia API key. Get a free one at https://app.ktemia.com/api-keys

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
546/sem
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.1.5
Publicado en el registroi
19 nov 2026
Último cambio de códigoi
19 nov 2026
Última revisión
19 nov 2026
Creador
Ktemiaa
Paquetes
npm: @ktemia/mcp
pypi: ktemia-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub Ktemiaa, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 253 ms (HTTP 401)

  • ✓ Superada

    Inicio de sesión con OAuth

    Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

Vulnerabilidades publicadas (OSV.dev)

Aún no revisado

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Viajes, mapas y climai

  • Más estrellas que el 92% de los otros 2025 servidores de esta categoría
  • Publicado en el registro más recientemente que el 99% de los otros 2025 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 2025 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Ktemia?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: X-API-Key, KTEMIA_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (0.1.5) llegó al registro ayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Mu

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

de microEn crecimiento★ 440Actualizado hace 4 meses

Se ejecuta en la nube✓ micro.mu

Killbottleneck

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

de tengolabsInicial↓ 328/sem★ 14Actualizado hace 13 días

Se ejecuta en tu computadora✓ del servicio · killbottleneck.com

Whimsical

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

de WhimsicalCodeInicial★ 11Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · whimsical.com
Comparado con otros parecidos
Este
Ktemia
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoSíNoNo
Se añade con + en ClaudeNoNoNoNoNoSí
Revisiones básicas5/54/43/33/34/44/4
LicenciaMITAGPL-3.0MITMITMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Solo se muestra el principio; lee el resto en el repo