# Calendario y Festivos

> Calendario y Festivos is a paid MCP server for public data. MCP server giving AI assistants official Spanish holiday and public datasets with source. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://calendarioyfestivos.com/para-ia
- **MCP Registry name:** com.calendarioyfestivos/mcp
- **Categories:** [public data](https://ai-powered.com/categories/public-data)
- **Listing updated:** 2026-11-19

## About

The server lets an assistant such as Claude, ChatGPT or Codex query the datasets and tools of Calendario y Festivos under the user's own account. Each result is meant to cite its official source and licence, so answers about holidays or public data can be traced back to the publisher.

Authentication uses OAuth 2.1: the user adds the server URL in the assistant, signs in on the vendor's page and approves access. Clients without OAuth can instead send an API key in an X-API-Key or Bearer header. The page says the assistant sees the same data and limits as the web account, including monthly tokens, rows per request and request rate limits.

Access requires a paid plan. The free plan only exposes the dataset catalogue and account information. Write permission is optional and only needed for managing alerts and webhooks; account payments, password changes and API key creation stay in the web interface.

## Features

- **Official dataset catalogue:** Lists available datasets with their source, licence and contents, and the plans that include them.
- **Filtered row queries:** Retrieves rows from a dataset with filters, pagination and history matching the REST API.
- **Tool execution:** Runs the tools available on the website, with data kept current where the plan allows it.
- **Account and usage lookup:** Shows the account, plan, token consumption and invoices.
- **Email alerts and webhooks:** Creates alerts for new matching rows and signed webhooks, with delivery history, when write access is granted.
- **Confirmation for destructive actions:** Asks the user to confirm before deleting or cancelling anything.

## Good for

- Look up official holiday calendars for a given country or region inside an AI chat
- Check a dataset's source and licence before reusing its figures
- Receive an email when new rows matching a filter are published
- Feed signed webhook events into an automated workflow
- Monitor token usage and plan limits from an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://api.calendarioyfestivos.com/mcp
```

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

```sh
https://api.calendarioyfestivos.com/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.calendarioyfestivos.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.calendarioyfestivos.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.calendarioyfestivos.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.calendarioyfestivos.com/mcp
```

Enter a Name (for example "Calendario y Festivos"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.calendarioyfestivos.com/mcp"
    }
  }
}
```

## Tools

- `listar_conjuntos`: Lists available datasets with source and licence.
- `describir_conjunto`: Describes the contents of a dataset.
- `ver_planes`: Shows what each plan includes.
- `consultar_filas`: Queries rows from a dataset with filters and pagination.
- `obtener_fila`: Retrieves a single dataset row.
- `listar_herramientas`: Lists tools available on the website.
- `usar_herramienta`: Runs a website tool.
- `mi_cuenta`: Shows account details.
- `mi_consumo`: Shows token consumption.
- `historial_consumo`: Shows consumption history.
- `mi_suscripcion`: Shows the subscription.
- `mis_facturas`: Lists invoices.
- `crear_alerta`: Creates an email alert for new matching rows.
- `actualizar_alerta`: Updates an alert.
- `borrar_alerta`: Deletes an alert.
- `crear_webhook`: Creates a signed webhook.
- `probar_webhook`: Tests a webhook.
- `rotar_secreto_webhook`: Rotates a webhook secret.
- `cancelar_suscripcion`: Cancels a subscription at period end, with confirmation.
- `reactivar_suscripcion`: Reactivates a subscription, with confirmation.
- `enlace_portal_facturacion`: Provides a billing portal link.

## FAQ

### Is there a free plan for the MCP server?

No. The page states that a paid plan is required; the free plan only shows the dataset catalogue and the user's account.

### How do I authenticate?

Through OAuth 2.1 by signing in and authorising the connection, or with an API key sent in the X-API-Key or Authorization Bearer header for clients without OAuth.

### Can the assistant change my subscription or account?

It can cancel or reactivate a subscription only with user confirmation. It cannot pay, upgrade, create API keys, change the password or delete the account; those are done on the website.

### Which clients are mentioned?

The page gives setup steps for Claude.ai, Claude Desktop, ChatGPT, Claude Code and Codex, and an API key example for Cursor and scripts.

### Is Calendario y Festivos free?

No. Calendario y Festivos is a paid product.

### How do I add Calendario y Festivos to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.calendarioyfestivos.com/mcp

### What are the best alternatives to Calendario y Festivos?

The closest alternatives to Calendario y Festivos are Alquiler y Vivienda, Licitaciones API, Paro y Oposiciones and UK Civic & Parliamentary Data MCP Server from MCPBundles.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 20 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Alquiler y Vivienda](https://ai-powered.com/mcp/alquiler-y-vivienda): Alquiler y Vivienda is a paid MCP server for public data.
- [Licitaciones API](https://ai-powered.com/mcp/licitaciones-api): Licitaciones API is a paid MCP server for government bids.
- [Paro y Oposiciones](https://ai-powered.com/mcp/paro-y-oposiciones): Paro y Oposiciones is a paid MCP server for legal and government.
- [UK Civic & Parliamentary Data MCP Server from MCPBundles](https://ai-powered.com/mcp/uk-civic-and-parliamentary-data-mcp-server-from-mcpbundles): UK Civic & Parliamentary Data MCP Server from MCPBundles is a freemium MCP server for public data.

---
Source: https://ai-powered.com/mcp/calendario-y-festivos
