Skip to main content
Glama
enesjakozh
linkcd

Tibber MCP

by linkcd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Servidor Tibber MCP

Este es un servidor de Protocolo de Contexto Modelo (MCP) para Tibber , un proveedor de energía noruego.

Puede ejecutar el servidor MCP localmente y acceder a él a través de diferentes hosts como Claude Desktop o Roo Code .

Para más detalles, consulta mi publicación del blog:
Creación de un servidor Tibber MCP: Conecte su agente de IA a los datos de consumo de energía

Descripción general

El servidor Tibber MCP proporciona a un agente de IA una forma conveniente de interactuar con la API de Tibber y consultar información como los precios actuales de la energía y sus datos de consumo de energía.

Related MCP server: Tigo Energy MCP Server

Consultas de ejemplo

Una vez conectado al servidor MCP, puede hacer preguntas como:

  • Analice mis datos de consumo energético y presente las horas pico habituales y cualquier otro patrón interesante en un formato fácil de leer.

  • "¿Cuándo utilicé más energía ayer?"

  • ¿Cuánta energía consumí ayer a las 7 de la mañana?

  • "¿Cuál es el precio actual de la energía?"

  • "Enumera las 3 horas más baratas del día de mañana."

  • "¿El precio de la energía será más alto o más bajo mañana?"

Vídeo de demostración

Demostración de Tibber MCP

Arquitectura

Arquitectura

Requisitos

Instalación

  1. Instalar uv :

    # On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
    # On Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  2. Clonar este repositorio:

    git clone https://github.com/linkcd/tibber-mcp.git
cd tibber-mcp

  3. Configure el entorno virtual de Python e instale las dependencias:

    uv venv --python 3.12 && source .venv/bin/activate && uv pip install --requirement pyproject.toml

Configuración del host

En Claude Desktop o Roo Code en VS

{
   "mcpServers":{
      "tibber":{
         "command":"uv",
         "args":[
            "--directory",
            "[PATH-TO-ROOT-OF-THE-CLONED-TIBBER-MCP-FOLDER]",
            "run",
            "server.py"
         ],
         "env":{
            "TIBBER_API_TOKEN":"[YOUR-TIBBER-TOKEN]"
         }
      }
   }
}

IMPORTANTE : Reemplace [YOUR-TIBBER-TOKEN] con su token real. Nunca envíe credenciales reales al control de versiones.

Depurar y probar el servidor MCP localmente

Ejecute el servidor localmente y ejecute el inspector MCP en él

npx @modelcontextprotocol/inspector -e TIBBER_API_TOKEN=[YOUR-TIBBER-TOKEN] python server.py

Herramientas disponibles

El servidor expone las siguientes herramientas que LLM puede utilizar:

  1. get_consumption_data() : Obtiene los datos de consumo por hora de los últimos 30 días, como período de tiempo, costo total, costo de energía base y kwh consumidos

  2. get_price_and_home_info() : Obtener información de precios (actual, hoy y mañana) e información de la vivienda (propietario, dirección, suscripción...)

Licencia

Licencia MIT

Expresiones de gratitud

  • Esta herramienta utiliza el marco MCP de Anthropic

  • Creado con FastMCP para implementación de servidor

  • La integración de tibber se basa en la biblioteca pyTibber

Available Tools

2 tools
get_consumption_dataB

Get the hourly consumption data for the last 30 days, such as time period, total cost, base energy cost, and consumpted kwh.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It describes the data returned but doesn't cover critical aspects like whether this is a read-only operation, potential rate limits, authentication needs, error conditions, or response format. For a data retrieval tool with zero annotation coverage, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that front-loads the key action and scope. It lists data fields concisely without redundancy. However, it could be slightly more structured by separating the action from the data details, but overall it's appropriately sized with minimal waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (data retrieval with no parameters) and lack of annotations and output schema, the description is incomplete. It covers what data is fetched but omits behavioral traits, usage context, and output details. For a tool with no structured support, the description should provide more comprehensive guidance to aid the agent effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0 parameters with 100% coverage, so the schema fully documents the lack of inputs. The description doesn't need to add parameter details, as there are none to explain. It implies the tool operates without user-provided parameters, which aligns with the schema. Baseline is 4 for zero parameters, as the description doesn't contradict or add unnecessary info.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get') and resource ('hourly consumption data'), specifying the time range ('last 30 days') and data fields (e.g., time period, total cost). It distinguishes from the sibling tool 'get_price_and_home_info' by focusing on consumption rather than price/home info, though it doesn't explicitly name the sibling. The purpose is specific but lacks explicit sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, such as the sibling tool 'get_price_and_home_info'. It mentions the data scope but doesn't explain use cases, prerequisites, or exclusions. This leaves the agent without clear context for tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_price_and_home_infoB

Get the infomation of: 1. current price, with price break down, price level, and currency 2. hourly price and price level of today 3. hourly price and price level of tomorrow 4. home address info, timezone etc the currency is applying to all prices

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It describes what data is returned but doesn't mention whether this is a read-only operation, potential rate limits, authentication needs, or error conditions. It lacks critical behavioral context for an agent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is structured as a bulleted list which helps organization, but contains minor spelling errors ('infomation') and could be more front-loaded. The information is reasonably concise but not optimally polished.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no parameters and no output schema, the description adequately explains what data is returned (price breakdowns, home info). However, without annotations or output schema, it should ideally provide more behavioral context about the operation's characteristics and return format.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters with 100% schema description coverage, so the schema already fully documents the empty parameter set. The description appropriately doesn't discuss parameters, maintaining focus on what the tool returns rather than what it accepts.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves price information (current, hourly today/tomorrow) and home address/timezone data. It specifies the verb 'Get' and resources (price data, home info), though it doesn't explicitly differentiate from the sibling tool 'get_consumption_data'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus the sibling 'get_consumption_data'. The description lists what data is retrieved but doesn't specify use cases, prerequisites, or alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updates
    • First observedget_consumption_data
    • First observedget_price_and_home_info
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.3/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one focuses on consumption data (historical usage and costs), while the other focuses on price information and home details (current, forecasted pricing and location/timezone). There is no overlap in functionality, making it easy for an agent to select the correct tool based on the query.

Naming Consistency5/5

Both tools follow a consistent verb_noun pattern with 'get_' prefix and descriptive names (get_consumption_data and get_price_and_home_info). The naming is predictable and readable, adhering to a clear convention throughout the set.

Tool Count3/5

With only 2 tools, the server feels thin for a domain like energy/utility management, which typically involves more operations such as setting preferences, controlling devices, or accessing billing history. While the tools cover key data retrieval aspects, the count is borderline low for comprehensive agent interaction.

Completeness3/5

The tools provide good read-only coverage for consumption and pricing data, but there are notable gaps: no update/delete operations, no ability to manage home settings or devices, and no support for actions like adjusting energy usage or handling billing. This limits the server to data retrieval only, which may cause agent failures in broader utility management tasks.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Tigo Energy MCP Server

    matt-dreyer
    A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides comprehensive access to Tigo Energy solar system data and analytics. It enables AI assistants to interact with your Tigo solar monitoring system to retrieve production data, performance metrics, system health information, and maintenance insights.
    MIT

  • emoncms-mcp-server

    guibrazlima
    F
    license
    Not graded
    quality
    D
    maintenance
    MCP server for EmonCMS energy monitoring API, enabling AI assistants to query energy feeds, inputs, and historical data.
    1
    -

  • Monta MCP Server

    nickknissen
    F
    license
    A
    quality
    D
    maintenance
    MCP server that enables LLMs to interact with Monta's EV charging platform for managing charge points, charging sessions, and wallet operations.
    7
    -

Appeared in Searches