# Votura MCP Server

[![smithery badge](https://smithery.ai/badge/eugene-labonarsky/votura-app)](https://smithery.ai/servers/eugene-labonarsky/votura-app)

Search AI-powered audio tours and points of interest by city. [Votura](https://votura.app) creates narrated walking, cycling, and driving tours with stop-by-stop audio guides, deep links, and multilingual support.

## MCP Server URL

```
https://api.votura.app/functions/v1/app_a0630e492b_mcp
```

No authentication required. Connect with just the URL.

## Tools

### `search_tours`

Search for audio tours near a city or coordinates.

**Parameters:**
- `city` (string) — City or place name, e.g. `"Paris"`, `"Rome"`, `"New York"`
- `latitude` / `longitude` (number) — Coordinates instead of city
- `transport_type` (string) — Filter by `walking`, `cycling`, or `driving`
- `max_duration_minutes` (number) — Only return tours shorter than this
- `language` (string) — Language code, e.g. `"en-US"`, `"fr-FR"`, `"de-DE"`

**Example response:**
```json
{
  "count": 12,
  "tours": [
    {
      "tour_id": "91e5cf1f-...",
      "name": "Rome's Historic Trails",
      "transport": "walking",
      "duration_minutes": 493,
      "stops_count": 6,
      "url": "https://votura.app/en/tours/91e5cf1f-..."
    }
  ]
}
```

---

### `get_tour_details`

Get full details for a specific tour including all stops and a deep link.

**Parameters:**
- `tour_id` (string, required) — UUID from `search_tours`
- `language` (string) — Language for the deep link URL

**Example response:**
```json
{
  "tour_id": "91e5cf1f-...",
  "name": "Rome's Historic Trails",
  "transport": "walking",
  "duration_minutes": 493,
  "distance_km": 8.2,
  "url": "https://votura.app/en/tours/91e5cf1f-...",
  "stops": [
    { "name": "Colosseum", "category": "landmark", "latitude": 41.89, "longitude": 12.49 }
  ]
}
```

---

### `search_places`

Find points of interest near a city, optionally filtered by category.

**Parameters:**
- `city` (string) — City or place name
- `latitude` / `longitude` (number) — Coordinates instead of city
- `category` (string) — Type of place: `castle`, `museum`, `park`, `church`, `brewery`, `cemetery`, `landmark`, `restaurant`
- `radius_meters` (number) — Search radius (default 15000)

**Example response:**
```json
{
  "count": 10,
  "places": [
    {
      "place_id": "abc123",
      "name": "Musée du Louvre",
      "address": "Rue de Rivoli, Paris",
      "rating": 4.7,
      "latitude": 48.8606,
      "longitude": 2.3376
    }
  ]
}
```

## Connect

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "votura": {
      "url": "https://api.votura.app/functions/v1/app_a0630e492b_mcp"
    }
  }
}
```

### Cursor / Windsurf

Add to your MCP settings:

```json
{
  "votura": {
    "url": "https://api.votura.app/functions/v1/app_a0630e492b_mcp"
  }
}
```

### Smithery CLI

```bash
smithery mcp add eugene-labonarsky/votura-app
```

## About Votura

[Votura](https://votura.app) is an AI-powered audio tour app for iOS, Android, and web. It generates custom narrated tours for any city in the world — walking, cycling, or driving — with turn-by-turn navigation and rich audio stories at every stop.

- [votura.app](https://votura.app)
- [App Store](https://apps.apple.com/app/votura-audio-travel-guide/id6752535942)
- [Google Play](https://play.google.com/store/apps/details?id=app.votura)