Runs non-urgent LLM tasks at the cleanest grid hour before a deadline, via Batch APIs when allowed.
Connect Runs on your machine
claude mcp add tidegap -e TIDEGAP_DEFAULT_REGION=<TIDEGAP_DEFAULT_REGION> -e TIDEGAP_DB_PATH=<TIDEGAP_DB_PATH> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e TIDEGAP_EIA_API_KEY=<TIDEGAP_EIA_API_KEY> -e TIDEGAP_ENTSOE_SECURITY_TOKEN=<TIDEGAP_ENTSOE_SECURITY_TOKEN> -e WATTTIME_USERNAME=<WATTTIME_USERNAME> -e WATTTIME_PASSWORD=<WATTTIME_PASSWORD> -e TIDEGAP_ELECTRICITY_MAPS_API_KEY=<TIDEGAP_ELECTRICITY_MAPS_API_KEY> -- npx -y @tidegap/[email protected]{
"mcpServers": {
"tidegap": {
"command": "npx",
"args": [
"-y",
"@tidegap/[email protected]"
],
"env": {
"TIDEGAP_DEFAULT_REGION": "<TIDEGAP_DEFAULT_REGION>",
"TIDEGAP_DB_PATH": "<TIDEGAP_DB_PATH>",
"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_USERNAME": "<WATTTIME_USERNAME>",
"WATTTIME_PASSWORD": "<WATTTIME_PASSWORD>",
"TIDEGAP_ELECTRICITY_MAPS_API_KEY": "<TIDEGAP_ELECTRICITY_MAPS_API_KEY>"
}
}
}
}{
"mcpServers": {
"tidegap": {
"command": "npx",
"args": [
"-y",
"@tidegap/[email protected]"
],
"env": {
"TIDEGAP_DEFAULT_REGION": "<TIDEGAP_DEFAULT_REGION>",
"TIDEGAP_DB_PATH": "<TIDEGAP_DB_PATH>",
"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_USERNAME": "<WATTTIME_USERNAME>",
"WATTTIME_PASSWORD": "<WATTTIME_PASSWORD>",
"TIDEGAP_ELECTRICITY_MAPS_API_KEY": "<TIDEGAP_ELECTRICITY_MAPS_API_KEY>"
}
}
}
}{
"servers": {
"tidegap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tidegap/[email protected]"
],
"env": {
"TIDEGAP_DEFAULT_REGION": "<TIDEGAP_DEFAULT_REGION>",
"TIDEGAP_DB_PATH": "<TIDEGAP_DB_PATH>",
"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_USERNAME": "<WATTTIME_USERNAME>",
"WATTTIME_PASSWORD": "<WATTTIME_PASSWORD>",
"TIDEGAP_ELECTRICITY_MAPS_API_KEY": "<TIDEGAP_ELECTRICITY_MAPS_API_KEY>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
TIDEGAP_DEFAULT_REGIONOptional | Default grid region, e.g. GB, US-CAL-CISO, DE |
TIDEGAP_DB_PATHOptional | SQLite queue path (default ~/.tidegap/queue.db) |
ANTHROPIC_API_KEYOptional, secret | Dispatch tasks to Anthropic (sync or Batch API) |
OPENAI_API_KEYOptional, secret | Dispatch tasks to OpenAI (sync or Batch API) |
TIDEGAP_EIA_API_KEYOptional, secret | US EIA grid data (CAISO, ERCOT, ISO-NE, PJM), free key |
TIDEGAP_ENTSOE_SECURITY_TOKENOptional, secret | ENTSO-E grid data (EU regions), free token |
WATTTIME_USERNAMEOptional | WattTime account (US marginal emissions) |
WATTTIME_PASSWORDOptional, secret | WattTime account password |
TIDEGAP_ELECTRICITY_MAPS_API_KEYOptional, secret | Electricity Maps fallback feed |
Details
| Package | @tidegap/[email protected] (NPM, stdio) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | io.github.tidegap/tidegap |
More productivity servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.