Tibber Energy Data Bridge Service (MCP Implementation)

This component functions as a Model Context Protocol (MCP) gateway specifically tailored for communicating with the services provided by Tibber, the Scandinavian electricity provider.

You are empowered to deploy this MCP endpoint locally and establish connectivity with various front-end applications, such as Claude Desktop or specialized IDE plugins like Roo Code.

For an in-depth technical walkthrough, please consult this accompanying technical article: Developing a Tibber MCP Gateway: Integrating AI Logic with Residential Energy Metrics

System Synopsis

The Tibber MCP gateway offers an Artificial Intelligence agent a streamlined conduit to interrogate the official Tibber Developer API, allowing retrieval of critical data points like instantaneous electricity rates and historical residential power consumption records.

Illustrative Interaction Prompts

Once this service endpoint is active and accessible, users can formulate complex queries such as: - "Conduct an analysis of my historical kilowatt-hour usage profile, detailing habitual peak consumption intervals and any emergent usage anomalies in a readily digestible format." - "Identify the specific temporal window during the preceding day when energy draw reached its maximum magnitude." - "Quantify the precise electrical energy volume consumed on the prior day at precisely 07:00 local time." - "What is the prevailing cost per unit of electrical power currently in effect?" - "Enumerate the three lowest-priced contiguous hours projected for the forthcoming calendar day." - "Compare the forthcoming day's electrical tariff against the present one, indicating whether it is an escalation or a reduction."

Demonstration Visual Aid

Underlying Structure

Prerequisites for Operation

• A system running Python version 3.12 or newer.
• A valid, authenticated Tibber API access key (obtainable via the Tibber Developer Configuration Area)

Deployment Procedure

1. Install the uv package manager: bash # For Unix-like operating systems (macOS/Linux) curl -LsSf https://astral.sh/uv/install.sh | sh

powershell # For Windows environments powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

1. Obtain a local copy of the source code repository: bash git clone https://github.com/linkcd/tibber-mcp.git cd tibber-mcp

2. Initialize the isolated Python environment and install necessary libraries: bash uv venv --python 3.12 && source .venv/bin/activate && uv pip install --requirement pyproject.toml

Host Environment Configuration

Configuration required for integration within the Claude Desktop or Roo Code environment in VS Code:

{ "mcpServers":{ "tibber":{ "command":"uv", "args":[ "--directory", "[ABSOLUTE-PATH-TO-THE-CLONED-TIBBER-MCP-DIRECTORY]", "run", "server.py" ], "env":{ "TIBBER_API_TOKEN":"[YOUR-SECRET-TIBBER-AUTHENTICATION-KEY]" } } } }

CRITICAL NOTICE: Substitute [YOUR-SECRET-TIBBER-AUTHENTICATION-KEY] with your actual authorization credential. Under no circumstances should sensitive access tokens be committed to persistent source control repositories.

Local Verification and Troubleshooting

Execute the service locally and subsequently direct the MCP Inspector utility towards it: bash npx @modelcontextprotocol/inspector -e TIBBER_API_TOKEN=[YOUR-SECRET-TIBBER-AUTHENTICATION-KEY] python server.py

Exposed Functionalities (Toolset)

The server exposes the following specialized functionalities for LLM utilization: 1. get_consumption_data(): Retrieves granular hourly electricity utilization metrics spanning the preceding thirty-day epoch, detailing time segmentation, aggregated monetary expenditure, the baseline energy charge component, and the cumulative kilowatt-hour volume consumed. 2. get_price_and_home_info(): Fetches current, daily, and prospective daily electricity tariff information, alongside vital residential metadata (e.g., account holder identification, physical situs address, service subscription tier).

Licensing Details

MIT License

Attributions

• This system leverages the foundational framework established by Anthropic's MCP specification.
• The server infrastructure is realized using the FastMCP framework.
• The core interaction layer with Tibber data is predicated upon the pyTibber library.