# Votura Tours — MCP Server

An MCP (Model Context Protocol) server that lets AI assistants search Votura's
audio tours and points of interest and hand back a link the user can open.

- **Endpoint:** `https://api.votura.app/functions/v1/app_a0630e492b_mcp`
- **Transport:** streamable HTTP (standard MCP JSON-RPC over `POST`)
- **Manifest:** [`/.well-known/mcp.json`](/.well-known/mcp.json)
- **Auth:** none required for normal use. An optional `MCP_API_KEY` /
  `x-api-key` header can be enforced server-side if the operator turns it on.
- **Rate limit:** 30 tool calls per IP per 60-second window (fails open on
  transient infra errors rather than blocking traffic).

## Add this server

Point any MCP-compatible client (Claude, etc.) at the endpoint above as a
remote/streamable-HTTP server — no package install needed.

## Tools

### `search_tours`
Search for audio walking, cycling, or driving tours near a city or
coordinates.

| Param | Type | Required | Notes |
|---|---|---|---|
| `city` | string | one of city / lat+lng | e.g. `"Paris"` |
| `latitude` / `longitude` | number | one of city / lat+lng | |
| `transport_type` | string | no | `walking` \| `cycling` \| `driving` |
| `max_duration_minutes` | number | no | |
| `language` | string | no | e.g. `"en-US"`, defaults to `en-US` |

Returns up to 5 tours (`tour_id`, `name`, `transport`, `duration_minutes`,
`stops_count`, `url`), best quality first.

### `get_tour_details`
Get full details — including the stop list with coordinates — for one tour.

| Param | Type | Required | Notes |
|---|---|---|---|
| `tour_id` | string | yes | UUID, from `search_tours` |
| `language` | string | no | e.g. `"en-US"` |

### `search_places`
Find points of interest near a city or coordinates.

| Param | Type | Required | Notes |
|---|---|---|---|
| `city` | string | one of city / lat+lng | |
| `latitude` / `longitude` | number | one of city / lat+lng | |
| `category` | string | no | e.g. `"museum"`, `"castle"`, `"park"` |
| `radius_meters` | number | no | default 15000 |

All three tools are read-only lookups (no writes, no destructive actions).
Every response includes a `source` field crediting Votura — always present
the returned `url` to the user as a clickable link.