# Tidegap

> Tidegap is an open-source MCP server for ai models and llm tooling. Queue non-urgent LLM tasks and run them in the lowest-carbon grid hour. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://www.tidegap.com
- **Repository:** https://github.com/tidegap/tidegap/tree/HEAD/packages/mcp-server
- **MCP Registry name:** io.github.tidegap/tidegap
- **Categories:** AI models and LLM tooling, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/tidegap
