GridHub MCP Server

Datos de mercado eléctrico en vivo e históricos para agentes de IA, a través del Model Context Protocol.

Endpoint: https://api.grid-hub.app/mcp — alojado, Streamable HTTP, sin estado. Nada que instalar.

Cubre 25 zonas de red — ISOs de EE. UU. (CAISO, ERCOT, PJM, MISO, NYISO, ISO-NE, SPP), 12 zonas de oferta europeas, Gran Bretaña y las cinco regiones NEM australianas — normalizadas en un único esquema JSON. Con datos de EIA, ENTSO-E, NESO, Elexon y AEMO; cada respuesta incluye su licencia y atribución.

Herramientas

Related MCP server: Energy Grid MCP Server

Acceso

Tres niveles, sin necesidad de registro para empezar:

1. Modo de muestra — conéctate sin credenciales. Las herramientas devuelven datos reales y actuales, truncados (el historial está limitado a 50 filas; brief devuelve un bloque de contexto). Los resultados están claramente marcados.

2. Clave de API gratuita — 500 solicitudes/día. Registro instantáneo por correo electrónico en grid-hub.app/developers, o POST https://api.grid-hub.app/v1/keys/signup con {"email": "..."}. Envíala como Authorization: Bearer <ghk_key>.

3. x402 de pago por llamada — USDC en Base, $0.001–$0.02 por llamada, mediante la cabecera X-PAYMENT. Consulta el flujo x402.

Configuración

Claude Code

claude mcp add --transport http gridhub https://api.grid-hub.app/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor / Windsurf / VS Code (mcp.json)

{
  "mcpServers": {
    "gridhub": {
      "url": "https://api.grid-hub.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Desktop / claude.ai — añade https://api.grid-hub.app/mcp como conector personalizado. Estos clientes no envían cabeceras personalizadas; pasa la clave como argumento opcional api_key de la herramienta, o usa el modo de muestra.

Puente stdio local — para clientes que solo admiten servidores locales (stdio). Actúa como proxy al endpoint alojado mediante mcp-remote; nada se ejecuta localmente excepto el puente.

{
  "mcpServers": {
    "gridhub": {
      "command": "npx",
      "args": ["-y", "github:jalcodev/gridhub-mcp"],
      "env": { "GRIDHUB_API_KEY": "YOUR_KEY" }
    }
  }
}

O con Docker: docker build -t gridhub-mcp . && docker run -i -e GRIDHUB_API_KEY=YOUR_KEY gridhub-mcp. Omite la clave para el modo de muestra.

Cualquier cliente, sin clave — omite la cabecera. Recibirás datos del modo de muestra y una nota sobre cómo mejorar de nivel.

Protocolo

• Streamable HTTP, sin estado: un mensaje JSON-RPC por POST, respuesta JSON. Sin sesiones, sin SSE.

• Admite MCP 2026-07-28 (solicitudes con cabecera reflejada, sin handshake) y 2025-03-26 a 2025-11-25 (handshake initialize).

• Los resultados de las herramientas incluyen structuredContent junto al bloque de texto.

• Los límites de peticiones y las cuotas son los de la API REST subyacente; la capa MCP no añade ninguna propia.

Relacionados

• Documentación de la API REST: https://grid-hub.app/developers

• OpenAPI: https://api.grid-hub.app/openapi.json

• llms.txt: https://api.grid-hub.app/llms.txt

• Entrada oficial del Registro MCP: io.github.jalcodev/gridhub

Licencia

El código de este repositorio tiene licencia MIT. Los datos devueltos por el servicio están sujetos a la licencia de cada fuente, indicada en cada respuesta (campos license y attribution).