# Hoy Planes

> Hoy Planes is a free MCP server for maps and travel. Find concerts, theatre and free events in 12 Spanish provinces by date, price and distance. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://www.hoyplanes.com/mcp/
- **Repository:** https://github.com/dmbejar/hoy-planes-mcp
- **MCP Registry name:** com.hoyplanes/hoy-planes
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

Content is in Spanish and covers Madrid, Barcelona, Valencia, Sevilla, Zaragoza, Baleares, Castellón, Alicante, Málaga, Asturias, Murcia and Cádiz. Plans include concerts, theatre, musicals, stand-up, exhibitions, family activities, festivals and free events, refreshed daily.

The search tool filters by province, date (today, tomorrow, this weekend, next week or a range up to 31 days), topic, occasion such as couples or rainy days, maximum price, free-only, keywords and distance from a point. Distance searches need coordinates supplied by the assistant, because the connector does not geocode. Results return the most popular first, or the nearest first, at most 20 per query, with a link to the full list on the website.

It is read-only, needs no account and cannot buy or book; tickets are bought from each plan's page. It collects no personal data, and limits are 60 queries per minute per address. Dates and prices are set by organisers, so check before going.

## Features

- **Province agendas:** Twelve Spanish provinces covered, updated daily.
- **Rich filters:** Date, theme, occasion, max price, free-only and keywords.
- **Distance search:** Nearest-first results from coordinates and a radius.
- **Plan details:** Upcoming days, price, venue address and full description.
- **No account needed:** Read-only and unauthenticated.
- **Query limits:** 20 plans per query and 60 queries per minute per address.

## Good for

- Ask what to do this weekend in Málaga
- Find free plans for children tomorrow in Madrid
- List concerts under 15 euros near a landmark
- Get theatre options in a date range

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hoy-planes https://mcp.hoyplanes.com
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.hoyplanes.com
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hoy-planes": {
      "url": "https://mcp.hoyplanes.com"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hoy-planes": {
      "type": "http",
      "url": "https://mcp.hoyplanes.com"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hoy-planes": {
      "serverUrl": "https://mcp.hoyplanes.com"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hoy-planes": {
      "type": "http",
      "url": "https://mcp.hoyplanes.com"
    }
  }
}
```

## Tools

- `buscar_planes`: Busca planes de ocio y cultura en una provincia española por fecha, categoría (temática), ocasión, palabras, precio máximo y distancia a unas coordenadas. Devuelve los más populares primero (o los más cercanos, si se pasan coordenadas), con su ficha en la web.
- `ver_plan`: Los detalles de un plan: próximos días, precio, lugar con dirección y coordenadas, descripción completa y su ficha en la web.
- `listar_provincias`: Las provincias con agenda (con sus planes vigentes) y los valores de temática, ocasión y fecha que acepta buscar_planes.

## FAQ

### Does it need an account?

No account or API key is needed.

### Can it book or buy tickets?

No. It is read-only; tickets are bought from the plan page on the website.

### Which language are results in?

Spanish.

### How many results per search?

Up to 20 per query, with a link to the full listing.

### Is Hoy Planes free?

Yes. Hoy Planes is free to use.

### How do I add Hoy Planes to Claude Code?

Run this command in your terminal: claude mcp add --transport http hoy-planes https://mcp.hoyplanes.com

### What are the best alternatives to Hoy Planes?

The closest alternatives to Hoy Planes are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/hoy-planes
