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_nodesBusca nudos por nombre, provincia, comunidad, red, operador, tensión, estado o MW mínimos; ordena por capacidad disponible.
get_nodeTodo sobre un nudo: capacidad actual por métrica con su fuente y fecha, columnas oficiales, notas, saturación, historial y últimos cambios.
get_node_historySerie mes a mes de la capacidad disponible de un nudo, un punto por publicación oficial.
list_changesCambios entre publicaciones: liberaciones, saturaciones, aumentos y reducciones, con filtros por tipo, métrica, provincia, red y periodo.
list_access_requestsSolicitudes 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_noticesAnuncios 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_overviewPanorama nacional: nudos por estado y red, y qué se movió en la última publicación.
list_sourcesFuentes 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
FreeProTeamEnterprise
Peticiones/mes50050 000500 000Sin límite
Peticiones/min10603001 200
Servidor MCP (asistentes IA)SíSíSíSí
Histórico3 mesesCompletoCompletoCompleto
Listas3Sin límiteSin límiteSin límite
Reglas de alerta125100Sin límite
WebhooksNo310Sin límite
Equipo1310Sin límite
Exportación a CSVNoSíSíSí