Servidor MCP
Los mismos datos que la API, para asistentes de IA. Conecta Claude, ChatGPT, Cursor o cualquier cliente del Model Context Protocol y pregunta en lenguaje natural.
Qué es
Un servidor del Model Context Protocol (MCP) en https://api.holgura.dev/mcp. Tu asistente descubre las herramientas, las llama cuando le preguntas por capacidad de acceso y recibe los datos oficiales con su fuente y su fecha.
Es de solo lectura: no puede cambiar nada en tu cuenta. Cada respuesta incluye la atribución (REE, CNMC), la fecha de la publicación reflejada y el aviso legal, para que el asistente cite de dónde sale cada cifra.
Prueba a preguntar
- ¿En qué nudos de transporte de Sevilla queda capacidad de demanda y cuánta?
- ¿Dónde se liberó capacidad en la última publicación de Red Eléctrica?
- ¿Cómo ha evolucionado ABADES 400 en los últimos meses? ¿Ha estado saturado?
- Busca nudos de transporte con la generación saturada pero con capacidad de inyección de almacenamiento (el filtro BESS), ordenados por MW disponibles.
- ¿Qué nudos de 400 kV liberaron más de 50 MW en los últimos tres meses, contando solo cambios desde un valor publicado?
- ¿Qué nudos de Andalucía pasaron de saturados a disponibles desde septiembre y cuál fue la mayor liberación?
Conectar
Dirección del servidor: https://api.holgura.dev/mcp
Sin clave funciona con el límite anónimo y los últimos 3 meses de historial. Con una clave gratuita (consola → Claves API) el asistente usa los límites de tu plan: envíala en la cabecera Authorization: Bearer.
Con tu cuenta, en un clic: al añadir el conector en Claude o ChatGPT elige «Iniciar sesión», entra en Holgura y autoriza. El asistente usará los límites de tu plan sin pegar ninguna clave.
Claude (web y escritorio): Ajustes → Conectores → Añadir conector personalizado, pega la dirección del servidor y elige «Sin inicio de sesión» o «Iniciar sesión».
ChatGPT, Cursor, VS Code y otros clientes: añade un servidor MCP remoto (HTTP) con esa misma dirección.
# sin clave / without a key (anonymous limits)
claude mcp add --transport http holgura https://api.holgura.dev/mcp
# con tu clave / with your key (the limits of your plan)
claude mcp add --transport http holgura https://api.holgura.dev/mcp \
--header "Authorization: Bearer hg_live_…"Herramientas
Nueve herramientas de lectura. Las descripciones que ve el asistente explican cuándo usar cada una.
| search_nodes | Busca nudos por nombre, provincia, comunidad, red, operador, tensión, estado o MW mínimos; ordena por capacidad disponible. |
| get_node | Todo sobre un nudo: capacidad actual por métrica con su fuente y fecha, columnas oficiales, notas, saturación, historial y últimos cambios. |
| get_node_history | Serie mes a mes de la capacidad disponible de un nudo, un punto por publicación oficial. |
| list_changes | Cambios entre publicaciones: liberaciones, saturaciones, aumentos y reducciones, con filtros por tipo, métrica, provincia, red y periodo. |
| list_access_requests | Solicitudes de acceso de demanda recibidas por REE en nudos de transporte: quién pide capacidad, cuánta, hasta cuándo se admite concurrencia y si el nudo va a concurso. |
| list_notices | Anuncios del BOE sobre instalaciones eléctricas y acceso a la red: autorizaciones, información pública, impacto ambiental, utilidad pública, concursos y regulación, por nudo, provincia o tema. |
| get_overview | Panorama nacional: nudos por estado y red, y qué se movió en la última publicación. |
| list_sources | Fuentes oficiales con su última publicación y el diccionario de métricas, estados y tipos de cambio. |
Una llamada
El protocolo es JSON-RPC sobre HTTPS (revisión 2026-07-28, sin sesiones; también atiende a clientes de revisiones anteriores). Cada resultado trae los datos estructurados y su copia en texto.
curl -s https://api.holgura.dev/mcp \
-H "Content-Type: application/json" \
-H "MCP-Protocol-Version: 2026-07-28" \
-H "Mcp-Method: tools/call" -H "Mcp-Name: search_nodes" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28",
"io.modelcontextprotocol/clientCapabilities":{}},
"name":"search_nodes",
"arguments":{"province":"Sevilla","status":"AVAILABLE","sort":"mw_desc","limit":5}}}'{
"jsonrpc": "2.0",
"id": 1,
"result": {
"resultType": "complete",
"isError": false,
"content": [{ "type": "text", "text": "{ …the same JSON as structuredContent… }" }],
"structuredContent": {
"meta": {
"timestamp_consult": "2026-11-12T09:00:00Z",
"source_data_mirror_date": "2026-11-03",
"disclaimer": "…",
"attribution": ["Red Eléctrica de España (REE) — …", "CNMC — …"],
"plan": "anonymous",
"history_months": 3
},
"data": [
{ "code": "ES-REE-DOSHERMANAS400", "name": "DOS HERMANAS 400", "network": "transmission",
"province": "Sevilla", "capacity": { "demand_available_mw": 212, "generation_available_mw": null } }
],
"page": { "limit": 5, "total": 14, "next_cursor": "5" }
}
}
}Cómo leer los datos
- null significa que el publicador no dio valor; no es cero. Un 0 es un cero publicado (el nudo está saturado para esa métrica).
- Las capacidades son informativas y no sumables: el servidor nunca suma métricas distintas ni cifras de REE y de la CNMC para el mismo nudo, y pide al asistente que tampoco lo haga.
- Holgura certifica que el reflejo coincide con el fichero oficial, no que la capacidad vaya a concederse. No es asesoramiento de inversión.
Límites
Una cuota, dos puertas: cada llamada a una herramienta cuenta como una petición de la cuota mensual de tu plan, compartida con la API REST. Descubrir el servidor y listar herramientas no cuenta.
- Sin clave: 10 llamadas por minuto por dirección y los últimos 3 meses de historial.
- Con clave: los límites de tu plan. Crear una clave gratuita
| Free | Pro | Team | Enterprise | |
|---|---|---|---|---|
| Peticiones/mes | 500 | 50 000 | 500 000 | Sin límite |
| Peticiones/min | 10 | 60 | 300 | 1 200 |
| Servidor MCP (asistentes IA) | Sí | Sí | Sí | Sí |
| Histórico | 3 meses | Completo | Completo | Completo |
| Listas | 3 | Sin límite | Sin límite | Sin límite |
| Reglas de alerta | 1 | 25 | 100 | Sin límite |
| Webhooks | No | 3 | 10 | Sin límite |
| Equipo | 1 | 3 | 10 | Sin límite |
| Exportación a CSV | No | Sí | Sí | Sí |