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 with uvx ktemia-mcp on 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: carClass in ktemia_search_cars was declared as a list, but POST /cars/search takes a single class, so any car search that set it was rejected with INVALID_REQUEST. Fixed in @ktemia/mcp 0.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/mcp on 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 at mcp.ktemia.com is 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_status is not metered, matching GET /key.

2026-11-16

  • New: GET /key reports 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 a QUOTA_EXCEEDED can 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.scope on GET /key says 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.com and never follows redirects.

2026-11-11

  • Hotels: providerUrl opens 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 with agencies. Ids come from availableFilters on a results page.
  • Cars: GET /cars/locations accepts type to narrow the lookup.

2026-11-06

2026-11-05

  • New: GET /cars/details expands one car into every seller’s price and booking URL.
  • Flights and cars: prices follow the country market. There is no currency field.
  • Hotels: stricter validation on POST /hotels/search, and results page with a nextToken.

2026-11-04

  • New: GET /flights/airports turns a place name into the airport or city code to send as origin or destination.
  • Cars: POST /cars/search returns a searchToken, and results page with tokens, the same as flights.

2026-11-03

Stop switching tabs to find a better deal.

One search. Flights, hotels, cars, and real estate - compared instantly.