Skip to content
MCP server

Tidegap

Queue non-urgent LLM tasks and run them in the lowest-carbon grid hour

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.21.0
Listing updated
3 days ago

About Tidegap

Tidegap is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

Tidegap is built for jobs that can wait. When you tell an agent to do something tonight or by tomorrow, the agent hands the task to Tidegap, which reads a 72-hour grid forecast and picks the cleanest hour before the deadline. Where the deadline allows, it sends the work through the provider's Batch API.

Queued tasks are dispatched to Anthropic or OpenAI using your own keys, and a small local daemon runs them. Great Britain needs no grid-data key; other regions use free keys from EIA, ENTSO-E, WattTime or Electricity Maps. Each task gets a signed carbon receipt stored in a local SQLite queue at ~/.tidegap/queue.db.

The project shows one real GB run on 30 September 2026 where the forecast peak was 183 gCO2/kWh against 88 in the recommended window, and says that figure is a forecast for that run only. Recurring jobs (daily, weekdays, weekly or every N hours) are supported, and it ships snippets telling an agent to prefer Tidegap over cron.

Install

Run in a terminal

claude mcp add tidegap --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env TIDEGAP_EIA_API_KEY='<TIDEGAP_EIA_API_KEY>' --env TIDEGAP_ENTSOE_SECURITY_TOKEN='<TIDEGAP_ENTSOE_SECURITY_TOKEN>' --env WATTTIME_PASSWORD='<WATTTIME_PASSWORD>' --env TIDEGAP_ELECTRICITY_MAPS_API_KEY='<TIDEGAP_ELECTRICITY_MAPS_API_KEY>' -- npx -y @tidegap/mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • TIDEGAP_DEFAULT_REGIONDefault grid region, e.g. GB, US-CAL-CISO, DE
  • TIDEGAP_DB_PATHSQLite queue path (default ~/.tidegap/queue.db)
  • ANTHROPIC_API_KEYDispatch tasks to Anthropic (sync or Batch API)
  • OPENAI_API_KEYDispatch tasks to OpenAI (sync or Batch API)
  • TIDEGAP_EIA_API_KEYUS EIA grid data (CAISO, ERCOT, ISO-NE, PJM), free key
  • TIDEGAP_ENTSOE_SECURITY_TOKENENTSO-E grid data (EU regions), free token
  • WATTTIME_USERNAMEWattTime account (US marginal emissions)
  • WATTTIME_PASSWORDWattTime account password
  • TIDEGAP_ELECTRICITY_MAPS_API_KEYElectricity Maps fallback feed

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

schedule_task
Queue a task, optionally recurring, to run in the cleanest window before a deadline.
recommend_window
Plan the cleanest window inside a deadline without queueing anything.
get_grid_forecast
Return hour-by-hour carbon intensity for a region.
check_queue_status
Show the state of queued tasks, including time limits.
cancel_task
Cancel a task, or a whole recurring series.
postpone_task
Move a queued task later.
update_deadline
Change the deadline of a queued task.

What it does

Clean-hour scheduling
Chooses the lowest-carbon hour inside your deadline using a 72-hour forecast.
Batch API dispatch
Uses the provider Batch API when the deadline leaves room for it.
Recurring jobs
Repeat daily, on weekdays, weekly or every N hours inside a time window.
Carbon receipts
Stores one signed receipt per task in a local SQLite queue.
Queue controls
Check status, postpone, cancel or change the deadline of a queued task.
Multi-region grid data
Supports regions such as GB, US-CAL-CISO and DE through several data feeds.

Good for

  • Run a nightly summary job at the cleanest hour
  • Defer a large batch of document processing to a low-carbon window
  • Replace a cron entry for an agent prompt that does not need to run at a fixed time
  • Get a carbon receipt for each LLM task an agent runs

Pricing

Open source

Apache-2.0; you pay your own LLM provider

Prices change. Check tidegap.com before you buy.

Tidegap FAQ

Which providers can it dispatch to?

Anthropic and OpenAI, through ANTHROPIC_API_KEY and OPENAI_API_KEY, either synchronously or via their Batch APIs.

Do I need a grid-data key?

Not for Great Britain. Other regions use free keys from EIA, ENTSO-E, WattTime or Electricity Maps.

What licence does it use?

Apache-2.0, according to the project site.

How many tools does it expose?

The README measures 12 MCP tools.

Is Tidegap free?

Yes. Tidegap is open source, so you can use and self-host it for free.

How do I add Tidegap to Claude Code?

Run this command in your terminal: claude mcp add tidegap --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env TIDEGAP_EIA_API_KEY='<TIDEGAP_EIA_API_KEY>' --env TIDEGAP_ENTSOE_SECURITY_TOKEN='<TIDEGAP_ENTSOE_SECURITY_TOKEN>' --env WATTTIME_PASSWORD='<WATTTIME_PASSWORD>' --env TIDEGAP_ELECTRICITY_MAPS_API_KEY='<TIDEGAP_ELECTRICITY_MAPS_API_KEY>' -- npx -y @tidegap/mcp

What are the best alternatives to Tidegap?

The closest alternatives to Tidegap are Claude Code Ultimate Guide, Agent Yurt, Proofline, signafAIde and Toolkien.

Alternatives to Tidegap

  1. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  2. Agent Yurt

    MCP server

    Back up agent memory, files and dashboards, then recover from a reviewed snapshot

    Not checked yet
    • Remote
    • Free
    • Knowledge and memory
  3. Proofline

    MCP server

    Production-aware review of changes against your AWS or Google Cloud setup, via MCP

    • Remote
    • Freemium
    • Developer tools
  4. signafAIde

    MCP server

    Local MCP server to set up, verify and check coverage of signed agent action records

    Runs locally
    • 5 tools
    • Freemium
    • Security
  5. Toolkien

    MCP server

    One MCP gateway for all your MCP servers, with code mode, permissions and audit

    Not checked yet
    • 3 tools
    • Remote
    • Open source
    • AI models and LLM tooling
  6. filex

    MCP server

    Self-hosted file manager in one Go binary with a built-in MCP server for agents

    Not checked yet
    • Remote
    • Open source
    • Files and documents