# Kipra for AI Agents — Kipra Rent A Car

URL: https://www.kiprarent.com/en/for-agents/

> A public MCP server for AI agents: live availability, prices and company facts for North Cyprus car rental. Read-only by design — a human completes the booking.

## In short

Kipra Rent A Car (Famagusta / Gazimağusa, North Cyprus) runs a public, read-only MCP server for AI agents at mcp.kiprarent.com. Agents query live car availability, total prices with insurance and VAT included, and company rules; the booking itself is always completed by a human on the website. The server is listed in the official MCP Registry and also offers an anonymous A2A endpoint.

## Connect

The MCP endpoint speaks Streamable HTTP and lives at a single address:

```
https://mcp.kiprarent.com/mcp
```

- To add it to Claude: Settings → Connectors → "Add custom connector", then paste the MCP endpoint URL. Auth is OAuth 2.1 with RFC 7591 dynamic client registration — no manual signup; consent is a single human click.
- Agents that don’t speak MCP can use the plain HTTP endpoints below — they return the same data.

The server is listed in the official MCP Registry as com.kiprarent/kipra-rent-a-car (domain ownership proven via DNS).

For agents speaking A2A protocol 1.0 there is an anonymous endpoint at https://mcp.kiprarent.com/a2a (JSON-RPC SendMessage; the same six capabilities, no authentication required).

## The six tools

All read-only — no tool can create, modify or cancel anything. Agents get data; humans book.

- **check_car_availability** — Returns the cars actually available for a pickup/return window, with total prices (insurance and VAT included) and a prefilled booking URL. Data is live from the booking engine — never cached or invented.
- **list_prices** — The current price list without dates: daily rates per vehicle category and rental-length tier (1 day / 2 days / 3–29 days / 30+ days), add-on prices and one-time location fees.
- **next_available** — Finds the soonest window a car is free for a requested number of days (duration_days is required — the agent asks rather than guessing).
- **company_info** — The company knowledge base: opening hours, deposit, driver-age rules, the border-crossing rule, transfers, payment. Agents answer only from the returned text.
- **get_fx_rates** — The current EUR-base exchange rates (TRY, USD, GBP) the booking engine uses. Agents never convert on their own — the same rates as the site.
- **get_booking_link** — Builds a booking URL prefilled with dates, language and display currency; the agent hands it to the human, who continues in one click.

## Data conventions

- Date-times are Cyprus local time (Europe/Nicosia), format YYYY-MM-DDTHH:mm.
- Cars are picked up and returned only within the booking hours, which change with the season — read them from /api/public/booking-hours (or company_info → booking_hours). Support and the Kipra assistant are available 24/7.
- Prices are returned in whole euros; optional *_quoted fields add TRY/USD/GBP amounts with the FX rate and its date.
- Business-negative answers ("no car free that week") are data, not errors.
- Result labels can be requested in Turkish or English via the language parameter.

## Plain HTTP endpoints

The public, unauthenticated GET endpoints behind the MCP tools — agents that don’t speak MCP can call them directly:

- `GET https://app.kiprarent.com/api/public/availability` — Availability + quote (note: amounts are in minor units / cents)
- `GET https://app.kiprarent.com/api/public/prices` — Price list (whole euros)
- `GET https://app.kiprarent.com/api/public/next-available` — Soonest free window (whole euros)
- `GET https://app.kiprarent.com/api/public/company-info` — Company knowledge base

- prices / next-available rule refusals return HTTP 200 {ok:false, error:<code>}; only malformed queries get a 400. availability refuses a window outside pickup/return hours with a 400 validation_failed (details: pickup_outside_hours / return_outside_hours).
- Rate limit: 60 requests/min/IP, pooled across prices / next-available / company-info.
- robots.txt explicitly allows /api/public/ — crawling is welcome by intent.

## Discovery files

The full machine-readable surface published for agent toolkits and crawlers:

- [llms.txt](https://www.kiprarent.com/llms.txt) — compact site index
- [llms-full.txt](https://www.kiprarent.com/llms-full.txt) — expanded full-content document
- [MCP server card](https://www.kiprarent.com/.well-known/mcp/server-card.json) — server description (SEP-1649)
- [A2A agent card](https://www.kiprarent.com/.well-known/agent-card.json) — supported interfaces & skills
- [auth.md](https://www.kiprarent.com/auth.md) — OAuth 2.1 registration & auth guide
- [API catalog](https://www.kiprarent.com/.well-known/api-catalog) — RFC 9727 linkset
- [Agent skills](https://www.kiprarent.com/.well-known/agent-skills/index.json) — Agent Skills Discovery index

## Trust model

- Read-only: no tool can write data, create or cancel a booking.
- Live data: quotes are never cached — agents see exactly the prices humans see.
- A human completes the booking: the agent only hands over a prefilled link. No credit card, no deposit.
- Agents never touch payment data — no online payments exist in the product (payment is cash or card at the office).
- Every core page has a clean .md mirror, and requesting a page with Accept: text/markdown returns Markdown instead of HTML.

## For customers: the Kipra assistant

Human customers get an AI assistant built on the same data: ask "Kipra" inside the booking flow (app.kiprarent.com/book/assistant) or talk to @kiprarent_bot on Telegram, by text or voice note. It quotes prices in EUR/TRY/USD/GBP and never guesses dates — it asks when it doesn’t know.

## Frequently asked

**Can an AI agent complete a booking?**

No — by design. Agents query availability and prices, then hand over a prefilled booking link. A human completes the booking on the website; no credit card or deposit is required.

**Is the data really live?**

Yes. Every answer comes in real time from the same booking engine humans use — same rate engine, same rules. No price is ever served from a cache or from the model’s memory.

**How do I add Kipra to Claude?**

Settings → Connectors → "Add custom connector", then paste https://mcp.kiprarent.com/mcp. Authorization runs automatically over OAuth; consent is one click.

**Which languages and currencies are supported?**

Result labels are available in Turkish or English. Prices are returned in whole euros, with TRY, USD and GBP equivalents at the same rates the site uses.

MCP Registry: com.kiprarent/kipra-rent-a-car · A2A: https://mcp.kiprarent.com/a2a
