API changelog
Last updated 18 November 2026
Changes to the public API contract at https://api.ktemia.com, newest first. There is no version prefix on the URL; changes that affect requests or responses are listed here. The full contract is the API reference, and the machine-readable spec is openapi.json.
2026-11-18
- New: the MCP server is on PyPI as
ktemia-mcp. Run it withuvx ktemia-mcpon Python 3.10 or newer. It has the same seven tools, wording, and behaviour as the npm package, because both read one shared contract file. Client configs for both are in MCP server. - Fixed:
carClassinktemia_search_carswas declared as a list, butPOST /cars/searchtakes a single class, so any car search that set it was rejected withINVALID_REQUEST. Fixed in@ktemia/mcp0.1.2. Use 0.1.3 or newer on either registry. The HTTP API itself was not affected. - Both packages are published from GitHub Actions with no long-lived registry token, and each release carries a provenance attestation tying it to the commit it was built from.
2026-11-17
- New: the Ktemia MCP server is published as
@ktemia/mcpon npm. It exposes seven read-only tools - key status, lookup, the three searches, details, and hotel reviews - to Cursor, Claude Code, Claude Desktop, Codex, and any other MCP client. Install and client configs are in MCP server. Source: Ktemiaa/ktemia-mcp. - The MCP server runs locally over stdio, so the key stays on the machine that runs it and is sent only to
https://api.ktemia.com. The hosted server atmcp.ktemia.comis still not live; earlier pages that described it as the way to connect were ahead of the build and have been corrected. - MCP tool calls are metered as ordinary API requests against the same monthly quota, with one exception:
ktemia_key_statusis not metered, matchingGET /key.
2026-11-16
- New:
GET /keyreports the plan, rate limits, and remaining monthly quota for the key you send. It is the only endpoint that is not metered: checking the allowance does not spend it, and the call keeps answering after the quota is gone, so aQUOTA_EXCEEDEDcan be diagnosed. It is still rate limited. - The monthly quota and the per-second rate limit are metered per account, not per key. Every key on an account draws down one shared allowance, so creating more keys does not raise the limit.
usage.scopeonGET /keysays which applies. - Clarified on pricing: the API, the MCP server, and the Cursor skills are available on every plan, including Free. A paid plan buys request volume and rate, not access to a surface. MCP tool calls are metered as ordinary API requests against the same monthly quota.
2026-11-14
- Published the OpenAPI spec for every public endpoint at /openapi.json.
- Published a public Postman workspace with every endpoint and the request examples from these docs. Fork it from Getting started.
- Added AGENTS.md with setup, auth, rules, and errors for coding agents.
2026-11-12
- Ktemia skills 1.0.1: the bundled client sends the API key only over HTTPS to
ktemia.comand never follows redirects.
2026-11-11
- Hotels:
providerUrlopens the booking site directly. Advertising redirect wrappers, including double-wrapped ones, are removed from booking links. - These docs are also published on GitHub and indexed on Context7.
2026-11-10
- Free plan: 100 API requests a month. See pricing.
2026-11-09
- Hotels and cars: filter results to named booking sites with
providers. Cars: filter to named rental companies withagencies. Ids come fromavailableFilterson a results page. - Cars:
GET /cars/locationsacceptstypeto narrow the lookup.
2026-11-06
- New:
GET /flights/airlinesturns an airline name into the 2-letter code for theairlinesfilter.
2026-11-05
- New:
GET /cars/detailsexpands one car into every seller’s price and booking URL. - Flights and cars: prices follow the
countrymarket. There is nocurrencyfield. - Hotels: stricter validation on
POST /hotels/search, and results page with anextToken.
2026-11-04
- New:
GET /flights/airportsturns a place name into the airport or city code to send asoriginordestination. - Cars:
POST /cars/searchreturns asearchToken, and results page with tokens, the same as flights.
2026-11-03
- Flights: a flat camelCase request body for
POST /flights/search, withlegsfor multi-city trips. - Flights:
GET /flights/resultsandGET /flights/detailsread thesearchToken. Results page with anextToken.