Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Tidegap

de tidegapversión 0.21.0i★ 3 (Estrellas de todo el repositorio)iSe ejecuta en tu computadora
Nombre en el registroio.github.tidegap/tidegap

Cómo instalar

What it does

Runs non-urgent LLM tasks at the cleanest grid hour before a deadline, via Batch APIs when allowed.

  • Connects Se ejecuta en tu computadora
  • Account or key Needs ANTHROPIC_API_KEY, OPENAI_API_KEY, TIDEGAP_EIA_API_KEY, TIDEGAP_ENTSOE_SECURITY_TOKEN, WATTTIME_PASSWORD, TIDEGAP_ELECTRICITY_MAPS_API_KEY
  • Category Búsqueda y memoria de IA

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de Tidegap (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Tidegap

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Tidegap ↗

  3. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  4. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "tidegap": {
          "command": "npx",
          "args": [
            "-y",
            "@tidegap/mcp"
          ],
          "env": {
            "ANTHROPIC_API_KEY": "your-value",
            "OPENAI_API_KEY": "your-value",
            "TIDEGAP_EIA_API_KEY": "your-value",
            "TIDEGAP_ENTSOE_SECURITY_TOKEN": "your-value",
            "WATTTIME_PASSWORD": "your-value",
            "TIDEGAP_ELECTRICITY_MAPS_API_KEY": "your-value"
          }
        }
      }
    }

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Cierra Claude y vuelve a abrirlo

  6. Pruébalo

    Usa Tidegap y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Tidegap o muestra una herramienta de Tidegap en la respuesta, ya está conectado

3 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TIDEGAP_DEFAULT_REGION Default grid region, e.g. GB, US-CAL-CISO, DE
  • TIDEGAP_DB_PATH SQLite queue path (default ~/.tidegap/queue.db)
  • WATTTIME_USERNAME WattTime account (US marginal emissions)

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Tidegap

Tidegap se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Tidegap

  • Necesitas una clave de Tidegap (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de Tidegap (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Tidegap (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Tidegap (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Búsqueda y memoria de IA que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de Tidegap (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Tidegap

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Tidegap ↗

  3. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  4. Pega este comando y pulsa Enter

    claude mcp add --scope user tidegap --env ANTHROPIC_API_KEY=your-value --env OPENAI_API_KEY=your-value --env TIDEGAP_EIA_API_KEY=your-value --env TIDEGAP_ENTSOE_SECURITY_TOKEN=your-value --env WATTTIME_PASSWORD=your-value --env TIDEGAP_ELECTRICITY_MAPS_API_KEY=your-value -- npx -y @tidegap/mcp

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Escribe /mcp en Claude Code

    Deberías ver Tidegap en la lista como conectado

  6. Pruébalo

    Usa Tidegap y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Tidegap o muestra una herramienta de Tidegap en la respuesta, ya está conectado

3 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TIDEGAP_DEFAULT_REGION Default grid region, e.g. GB, US-CAL-CISO, DE
  • TIDEGAP_DB_PATH SQLite queue path (default ~/.tidegap/queue.db)
  • WATTTIME_USERNAME WattTime account (US marginal emissions)

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de Tidegap (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Tidegap

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Tidegap ↗

  3. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de Tidegap, ANTHROPIC_API_KEY, OPENAI_API_KEY, TIDEGAP_EIA_API_KEY, TIDEGAP_ENTSOE_SECURITY_TOKEN, WATTTIME_PASSWORD, TIDEGAP_ELECTRICITY_MAPS_API_KEY está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de Cursor en modo Agent

  6. Pruébalo

    Usa Tidegap y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Tidegap o muestra una herramienta de Tidegap en la respuesta, ya está conectado

3 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TIDEGAP_DEFAULT_REGION Default grid region, e.g. GB, US-CAL-CISO, DE
  • TIDEGAP_DB_PATH SQLite queue path (default ~/.tidegap/queue.db)
  • WATTTIME_USERNAME WattTime account (US marginal emissions)

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de Tidegap (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Tidegap

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Tidegap ↗

  3. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de Tidegap, ANTHROPIC_API_KEY, OPENAI_API_KEY, TIDEGAP_EIA_API_KEY, TIDEGAP_ENTSOE_SECURITY_TOKEN, WATTTIME_PASSWORD, TIDEGAP_ELECTRICITY_MAPS_API_KEY está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de VS Code en modo Agent

  6. Pruébalo

    Usa Tidegap y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Tidegap o muestra una herramienta de Tidegap en la respuesta, ya está conectado

3 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TIDEGAP_DEFAULT_REGION Default grid region, e.g. GB, US-CAL-CISO, DE
  • TIDEGAP_DB_PATH SQLite queue path (default ~/.tidegap/queue.db)
  • WATTTIME_USERNAME WattTime account (US marginal emissions)

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Tidegap💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user tidegap --env ANTHROPIC_API_KEY=your-value --env OPENAI_API_KEY=your-value --env TIDEGAP_EIA_API_KEY=your-value --env TIDEGAP_ENTSOE_SECURITY_TOKEN=your-value --env WATTTIME_PASSWORD=your-value --env TIDEGAP_ELECTRICITY_MAPS_API_KEY=your-value -- npx -y @tidegap/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "tidegap": {
      "command": "npx",
      "args": [
        "-y",
        "@tidegap/mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your-value",
        "OPENAI_API_KEY": "your-value",
        "TIDEGAP_EIA_API_KEY": "your-value",
        "TIDEGAP_ENTSOE_SECURITY_TOKEN": "your-value",
        "WATTTIME_PASSWORD": "your-value",
        "TIDEGAP_ELECTRICITY_MAPS_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "tidegap": {
      "command": "npx",
      "args": [
        "-y",
        "@tidegap/mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your-value",
        "OPENAI_API_KEY": "your-value",
        "TIDEGAP_EIA_API_KEY": "your-value",
        "TIDEGAP_ENTSOE_SECURITY_TOKEN": "your-value",
        "WATTTIME_PASSWORD": "your-value",
        "TIDEGAP_ELECTRICITY_MAPS_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "tidegap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tidegap/mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your-value",
        "OPENAI_API_KEY": "your-value",
        "TIDEGAP_EIA_API_KEY": "your-value",
        "TIDEGAP_ENTSOE_SECURITY_TOKEN": "your-value",
        "WATTTIME_PASSWORD": "your-value",
        "TIDEGAP_ELECTRICITY_MAPS_API_KEY": "your-value"
      }
    }
  }
}

Valores que debes completar

  • TIDEGAP_DEFAULT_REGION env
    Default grid region, e.g. GB, US-CAL-CISO, DE
  • TIDEGAP_DB_PATH env
    SQLite queue path (default ~/.tidegap/queue.db)
  • ANTHROPIC_API_KEY secreto obligatorio env
    Dispatch tasks to Anthropic (sync or Batch API)
  • OPENAI_API_KEY secreto obligatorio env
    Dispatch tasks to OpenAI (sync or Batch API)
  • TIDEGAP_EIA_API_KEY secreto obligatorio env
    US EIA grid data (CAISO, ERCOT, ISO-NE, PJM), free key
  • TIDEGAP_ENTSOE_SECURITY_TOKEN secreto obligatorio env
    ENTSO-E grid data (EU regions), free token
  • WATTTIME_USERNAME env
    WattTime account (US marginal emissions)
  • WATTTIME_PASSWORD secreto obligatorio env
    WattTime account password
  • TIDEGAP_ELECTRICITY_MAPS_API_KEY secreto obligatorio env
    Electricity Maps fallback feed

Las descripciones siguen en el inglés original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHubi
3 (Estrellas de todo el repositorio)
Este repositorio tiene varias fichas MCP; sus estrellas cuentan una sola vez en las clasificaciones
Descargas por semanai
280/sem
Licenciai
Apache-2.0
Conexión
Se ejecuta en tu computadora
Última versióni
0.21.0
Publicado en el registroi
13 nov 2026
Último cambio de códigoi
13 nov 2026
Creador
tidegap
Paquetes
npm: @tidegap/mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 14 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub tidegap, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ✓ Superada

    Tiene licencia

    Usa Apache-2.0

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Búsqueda y memoria de IAi

  • Más estrellas que el 0% de los otros 6092 servidores de esta categoría
  • Publicado en el registro más recientemente que el 96% de los otros 6092 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 6092 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Tidegap?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: ANTHROPIC_API_KEY, OPENAI_API_KEY, TIDEGAP_EIA_API_KEY, TIDEGAP_ENTSOE_SECURITY_TOKEN, WATTTIME_PASSWORD, TIDEGAP_ELECTRICITY_MAPS_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (0.21.0) llegó al registro ayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Context7, Codebase Memory, OpenSEO

Otros de la misma categoría

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Context7

Up-to-date docs for AI agents

de upstashMuy usado↓ 1,2 M/sem★ 64,8 milActualizado anteayer

Computadora o nube

Codebase Memory

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

de DeusDataMuy usado↓ 16,8 mil/sem★ 48,6 milActualizado hace 28 días

Se ejecuta en tu computadora

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

de every-appMuy usado★ 27,6 milActualizado hoy

Se ejecuta en la nube✓ everyapp.com

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

@tidegap/mcp

Renamed from @ebb-ai/mcp in 0.18.0. Use the host config key tidegap and npx -y @tidegap/mcp; the ebb-mcp bin and the EBB_* variables were removed in 0.19. See Renamed from Ebb AI.

MCP server that lets your agent run non-urgent LLM tasks at the cleanest grid hour before a deadline.

Add it to any MCP host. When a user says "do this tonight" or "by tomorrow", the agent calls schedule_task. Tidegap then runs the task at the lowest-carbon grid hour before the deadline, and through the provider Batch API when the deadline allows.

  • 12 MCP tools (measured), among them recommend_window, schedule_task, check_queue_status, get_grid_forecast, cancel_task, postpone_task, update_deadline.
  • Live 72-hour forecast. GB needs no key; other regions use free keys (EIA, ENTSO-E, WattTime, Electricity Maps).
  • One signed carbon receipt per task, stored in ~/.tidegap/queue.db.
npx -y @tidegap/mcp
{ "mcpServers": {

"tidegap": { "command": "npx", "args": ["-y", "@tidegap/mcp"] } } }

Proof: one real GB run, 2026-09-30. Forecast peak 183 gCO2/kWh vs recommended window 88 gCO2/kWh, about 52 % lower for this run only (forecast, projected). Receipt at dispatch: 158 gCO2/kWh (measured). Host-specific configs: https://www.tidegap.com/docs#install

Run

npx -y @tidegap/mcp

The server speaks MCP over stdio. To wire it into an agent client:

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS (Linux/Windows have similar paths):

{

"mcpServers": { "tidegap": { "command": "npx", "args": ["-y", "@tidegap/mcp"], "env": { "TIDEGAP_ELECTRICITY_MAPS_API_KEY": "optional - mock data without it", "TIDEGAP_DEFAULT_REGION": "US-CAL-CISO" } } } }

Restart Claude Desktop after editing.

Claude Code

Add tidegap to your ~/.claude/mcp.json (or workspace .claude/mcp.json):

{

"mcpServers": { "tidegap": { "command": "npx", "args": ["-y", "@tidegap/mcp"] } } }

OpenClaw

Add to ~/.openclaw/mcp.json:

{

"mcpServers": { "tidegap": { "command": "npx", "args": ["-y", "@tidegap/mcp"] } } }

Tools exposed (12, measured)

ToolPurpose
schedule_task(... repeat?, every_hours?, days?, window?, time_zone?) with repeat daily, weekdays, weekly or every_n_hoursCreate a recurring job: each run is a new task at the cleanest hour of its period. End it with cancel_task(series: true).
get_grid_forecast(region, hours?)Hour-by-hour carbon intensity for a region; useful before deciding whether to defer.
recommend_window(deadline, region?, ...)Plan the cleanest window inside the deadline without queueing anything.
schedule_task(prompt, deadline, model?, region?, carbon_budget_g?, repeat?, origin_session_id?, not_before?)Queue a task to run in the cleanest window inside the deadline. Returns a task_id and one line that says whether it will run: Runs at local., or the readiness sentence with its fix, for example Tasks will not run: no tick daemon. Run `tidegap install`.. not_before sets the earliest start. repeat defaults to none, also for deadline_kind: "quota_reset".
schedule_task(... runner?, cwd?, permission_profile?, result_path?, wake_session?)Hand off the work shape: runner is another name for provider; cwd is the folder a claude-code run works in (another folder than the session's runs fresh there); permission_profile is read, web or none (read with a cwd); result_path is a new file Tidegap writes the result text to, inside cwd, the session's project folder or the temp folder. wake_session: true wakes the idle Claude Code session that queued the task when it finishes (within 12 hours after its last turn; refused outside a session). runner or provider command is refused with the tidegap queue add --runner command line. output_path follows the same folder rules.
check_queue_status(task_id?)Inspect the queue or one specific task; includes a carbon receipt once the task has completed.
cancel_task(task_id, series?)Cancel a queued or scheduled task; on a repeating task, skip it, or end the series with series: true.
reply_task(task_id, text, deadline?)Continue a completed task: a new task with the conversation plus this text, same provider and model.
expedite_task(task_id)Dispatch a queued or scheduled task now, outside its carbon window.
`postpone_task(task_id, preset? \until? \delay_minutes?, reset_at?)`"Later": move a pending task later, never earlier. Presets 1h, tonight (22:00 to 06:00), tomorrow_morning (09:00 to 12:00), after_limit_reset (5 minutes after the Claude limit reset: reset_at, else this machine's limit reading, else a reset time given before).
update_deadline(task_id, deadline)Reschedule a task against a new deadline.
retry_task(task_id)Re-dispatch a failed task.
cancel_all(status?)Cancel every task that is still queued or scheduled.
tidegap_usage(include_spend?)Read-only: the Claude Code subscription limits of this machine and when they reset, and the Codex limits from its local logs. include_spend adds the current 5-hour window's tokens and an API list-price cost estimate.

Environment variables

These variables configure this MCP server (and the tidegap CLI, which reads the same set). They are read at the server's own entry point and injected into @tidegap/core, which is environment-pure and reads nothing ambient itself.

OpenClaw plugin users: the @vitalini/tidegap OpenClaw plugin reads no

environment variables. Configure it through plugin config instead, under

plugins.entries.tidegap.config in your gateway config — the "Plugin config"

column below names the field that replaces each variable. OpenClaw resolves

the "${ENV_VAR}" shorthand in those fields, so you can keep exporting the

same variables and let the gateway read them on the plugin's behalf.

VarPlugin configPurpose
TIDEGAP_ELECTRICITY_MAPS_API_KEYelectricityMapsApiKeyAPI key from electricitymaps.com. Universal fallback. If unset (and no zone-specific feed is configured), the server falls back to deterministic mock data so you can still run the whole stack locally.
TIDEGAP_EIA_API_KEYeiaApiKeyFree US EIA key. Enables average-emissions intensity for the US ISO zones (CAISO / ERCOT / ISO-NE / NYISO / PJM / MISO).
TIDEGAP_ENTSOE_SECURITY_TOKENentsoeSecurityTokenFree ENTSO-E token. Enables EU zone intensity (FR / DE / ES / IT / NL).
WATTTIME_USERNAME + WATTTIME_PASSWORDwattTimeUsername + wattTimePasswordFree WattTime v3 account. Enables marginal-emissions (co2_moer) forecasts for the US ISO zones — takes precedence over EIA where covered, falls through to EIA on any error. The marginal signal is disclosed as signalType: "marginal" on forecasts and receipts.
TIDEGAP_DEFAULT_REGIONdefaultRegionRegion when a tool call names none. Beats the stored region setting; see Grid region.
ANTHROPIC_API_KEYanthropicApiKeyEnables the anthropic provider (batch-capable).
OPENAI_API_KEYopenaiApiKeyEnables the openai provider (batch-capable).
GEMINI_API_KEY / GOOGLE_API_KEYgeminiApiKey / googleApiKeyEnables the gemini provider (Generative Language API, sync-only). GEMINI_API_KEY is preferred; GOOGLE_API_KEY is the fallback.
OLLAMA_HOSTollamaHostEnables the local ollama provider (sync-only). Default http://localhost:11434; keyless — set this var to opt the provider in.

Grid region

The server resolves the region of each tool call in this order:

  1. the tool call's region argument,
  2. TIDEGAP_DEFAULT_REGION in the server's environment (the agent host's MCP config),
  3. the region setting stored on this machine: tidegap region set , or Settings → Grid region in tidegap ui and the Mac app (key TIDEGAP_DEFAULT_REGION in ~/.tidegap/config),
  4. a guess from the machine's time zone,
  5. GB.

The server reads the setting again when the file changes, so a new setting applies on the next tool call with no restart. A stored value that is not a supported zone is ignored, with one stderr warning per change. schedule_task replies carry region_source: flag | env | setting | timezone | fallback.

A region argument must be one of the 31 supported zones (any case). Another value is rejected with the closest zones and a link to request a region, for example Unknown zone UA. Closest: PL. Request a region: . With TIDEGAP_ELECTRICITY_MAPS_API_KEY set, any zone passes, because Electricity Maps serves zones beyond the list; with TIDEGAP_ENTSOE_SECURITY_TOKEN set, IT passes too.

Develop

From the root of a clone of https://github.com/tidegap/tidegap:

pnpm install

pnpm --filter @tidegap/mcp build node packages/mcp-server/dist/server.js