El servidor MCP de tus
tarifas de luz y gas

Qué es

El MCP (Model Context Protocol) es el estándar que permite a un modelo de IA usar herramientas externas de forma nativa. PriceVault expone su catálogo de tarifas como servidor MCP: tu agente descubre las herramientas disponibles y las usa solo, sin que tú escribas la integración.

Es la misma API /v1 que ya documentamos en la referencia de la API, con los mismos datos y los mismos cálculos. La diferencia es quién la llama: en vez de tu código, tu agente.

Cómo conectar tu agente

claude mcp add --transport http pricevault https://pricevault.es/mcp/ \
  --header "X-API-Key: pv_live_xxxxxxxxxxxxxxxxxxxx"

{
  "mcpServers": {
    "pricevault": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://pricevault.es/mcp/",
        "--header", "X-API-Key:${PV_KEY}"
      ],
      "env": { "PV_KEY": "pv_live_xxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

Herramientas disponibles

Solo de lectura y cálculo. Cada una corresponde a un endpoint de la API /v1, así que devuelven exactamente lo mismo que si llamaras por REST.

La más valiosa para un agente es ranking_eficiencia: le pasas el perfil de consumo del cliente y devuelve cada tarifa con su nota de precio, su nota de comisión y una nota combinada, señalando la más barata, la de más comisión y la más eficiente. El parámetro w (de 0 a 1, por defecto 0,5) pondera ahorro frente a comisión, así que tu agente decide el equilibrio según el perfil comercial de cada cliente.

Solo lectura, por construcción

Un agente de IA es autónomo y su configuración vive en el equipo de quien lo usa. Por eso el MCP no puede tocar tus datos, y no depende de que configures nada bien: son dos capas independientes.

Capa 1 — el servidor no expone escritura

Solo se registran las herramientas de la tabla de arriba. No existe ninguna herramienta de crear, editar, cargar en masa o eliminar que el agente pueda llamar, porque no se genera. Lo que no está en la lista, no existe.

Capa 2 — la key no puede escribir

La key de MCP se acuña con exactamente tres permisos de lectura y ninguno más. Si se filtrase desde la configuración de tu cliente de IA, físicamente no podría escribir ni borrar nada, ni siquiera llamando a la API REST directamente.

En particular, nunca incluye clients:read: el agente no ve tu cartera de clientes. Y si atas la key a un cliente concreto, solo verá las tarifas de ese cliente — con un matiz que conviene conocer: listar_comercializadoras devuelve el catálogo de comercializadoras de toda la cuenta, porque no depende del cliente.

Precio y límites

El MCP está incluido en todos los planes, sin coste adicional ni add-on. PriceVault cobra por número de clientes activos, no por llamadas, así que las llamadas de tu agente no se facturan por muy hablador que sea.

Lo único que aplica es un rate limit de uso razonable (anti-abuso), no una cuota. Escala con el plan en dos niveles: un techo por cuenta y, para las keys atadas a un cliente concreto, un sub-límite por cliente que evita que un agente se coma el presupuesto de los demás. Al superarlo, la respuesta es 429.

Privacidad y datos

Por parte de PriceVault:

• El transporte va siempre por TLS; nunca datos de consumo por un canal sin cifrar.
• El hosting está en la UE, y el endpoint MCP vive en la misma región que el resto de la plataforma.
• El registro de uso guarda solo metadatos — endpoint, código de estado y latencia. El cuerpo de la petición, con los datos de consumo de tu cliente, no se registra.

Preguntas frecuentes