GridHub MCP Server

AI 에이전트를 위한 실시간 및 과거 전력 시장 데이터로, Model Context Protocol을 통해 제공됩니다.

엔드포인트: https://api.grid-hub.app/mcp — 호스팅형, Streamable HTTP, 무상태. 설치할 것이 없습니다.

25개 그리드 존을 포함합니다 — 미국 ISO(CAISO, ERCOT, PJM, MISO, NYISO, ISO-NE, SPP), 12개 유럽 입찰 구역, 영국, 호주 NEM 5개 지역 — 하나의 JSON 스키마로 정규화했습니다. EIA, ENTSO-E, NESO, Elexon, AEMO에서 데이터를 수집하며, 모든 응답에는 라이선스와 출처 정보가 포함됩니다.

도구

Related MCP server: Energy Grid MCP Server

액세스

세 가지 등급이 있으며, 시작하는 데 가입이 필요 없습니다:

1. 샘플 모드 — 자격 증명 없이 연결합니다. 도구는 실제 최신 데이터를 반환하되 제한된 형태로 반환합니다(히스토리는 50행으로 제한, brief는 컨텍스트 블록 1개 반환). 결과에는 명확히 표시됩니다.

2. 무료 API 키 — 하루 500회 요청. grid-hub.app/developers에서 즉시 이메일 가입하거나, {"email": "..."}와 함께 POST https://api.grid-hub.app/v1/keys/signup을 호출하세요. Authorization: Bearer <ghk_key>로 전송하세요.

3. x402 건별 과금 — Base의 USDC로 호출당 $0.001–$0.02, X-PAYMENT 헤더를 통해 결제합니다. x402 흐름을 참조하세요.

설정

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 — https://api.grid-hub.app/mcp를 사용자 지정 커넥터로 추가하세요. 이 클라이언트들은 사용자 지정 헤더를 보내지 않으므로, 선택적 api_key 도구 인수로 키를 전달하거나 샘플 모드를 사용하세요.

로컬 stdio 브리지 — 로컬(stdio) 서버만 지원하는 클라이언트용입니다. mcp-remote를 통해 호스팅 엔드포인트로 프록시하며, 브리지 외에는 로컬에서 실행되는 것이 없습니다.

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

또는 Docker 사용: docker build -t gridhub-mcp . && docker run -i -e GRIDHUB_API_KEY=YOUR_KEY gridhub-mcp. 샘플 모드에서는 키를 생략하세요.

키 없이 모든 클라이언트 — 헤더를 생략하세요. 샘플 모드 데이터와 업그레이드 방법에 대한 안내를 받게 됩니다.

프로토콜

• Streamable HTTP, 무상태: POST당 JSON-RPC 메시지 하나, JSON 응답. 세션 없음, SSE 없음.

• MCP 2026-07-28(헤더 미러링 요청, 핸드셰이크 없음) 및 2025-03-26~2025-11-25(initialize 핸드셰이크)를 지원합니다.

• 도구 결과에는 텍스트 블록과 함께 structuredContent가 포함됩니다.

• 속도 제한 및 할당량은 기본 REST API의 것을 따르며, MCP 계층은 자체 제한을 추가하지 않습니다.

관련 자료

• REST API 문서: https://grid-hub.app/developers

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

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

• 공식 MCP 레지스트리 항목: io.github.jalcodev/gridhub

라이선스

이 저장소의 코드는 MIT 라이선스입니다. 서비스가 반환하는 데이터는 각 소스의 라이선스를 따르며, 모든 응답(license 및 attribution 필드)에 명시되어 있습니다.