Skip to main content
Glama

Commerce for Agents

Energy Tariff Details

tariff-details
Read-onlyIdempotent

Full conditions for one tariff from a previous compare-tariffs result: price composition, price guarantee scope, contract duration/prolongation/cancellation, deposit, energy-source mix, customer ratings, and for eco tariffs the required eco statement + proof (quote verbatim). Keywords: Tarifdetails, Vertragsbedingungen, Preisgarantie, Kündigungsfrist, Vertragslaufzeit, AGB, tariff conditions, contract details. Input is the ref of an offer from compare-tariffs. Call when the user asks about a specific tariff's conditions before deciding. Answer in the user's language.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
refYesOffer reference from a compare-tariffs result (field `ref`).
languageNoLanguage of the conversation (for the eco statement and proof texts). Default: de.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
ecoNo
refYes
tariffYes
remarksNo
contractYes
providerYes
energyTypeYes
costBreakdownYes
energySourcesNo
annualTotalEurYes
customerRatingsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • removedInput schema / properties / context
      Removed value: -{
      -  "description": "Why are you calling this tool? Briefly describe the user's goal.",
      -  "type": "string"
      -}
    • changedInput schema / required
      Previous value: -[
      -  "ref",
      -  "context"
      -]New value: +[
      +  "ref"
      +]
  2. First observed

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, openWorldHint=true, idempotentHint=true, and destructiveHint=false, covering the safety profile. The description adds behavioral context beyond this: it must quote the eco statement verbatim, answer in the user's language, and returns a broad set of contract details. No contradictions with annotations.

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 structured with a clear lead sentence, a colon-delimited list of contents, and usage guidance at the end. The keywords list (e.g., 'Tarifdetails', 'AGB') is somewhat redundant for an AI agent but can aid search; it is not harmful. Overall, each sentence earns its place without being overly verbose.

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

Completeness4/5

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

The tool is a read-only lookup with only two parameters, an output schema exists, and annotations cover safety. The description lists all key condition categories the agent will receive, and it specifies the input requirement and language behavior. Nothing critical is missing for selecting and invoking the tool correctly.

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?

Schema description coverage is 100% for both parameters, so the baseline is 3. The description adds nuance beyond the schema: it specifies that `ref` must come from a compare-tariffs result (reinforcing the schema's wording) and clarifies that `language` is used for eco statement/proof texts, which the schema only says 'language of the conversation'. This extra context helps the agent understand the parameter's role.

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

Purpose5/5

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

The description clearly states a specific verb and resource: "Full conditions for one tariff from a previous compare-tariffs result" and enumerates the exact content (price composition, guarantee, contract terms, eco proof). It differentiates from siblings like compare-tariffs (which compares) and book-contract (which acts) by scoping to a single tariff's detailed conditions.

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

Usage Guidelines4/5

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

Provides explicit when-to-use guidance: "Call when the user asks about a specific tariff's conditions before deciding." It also connects to compare-tariffs by requiring the `ref` from that result, implying a sequencing. It does not explicitly mention when-not-to-use or name alternative tools, so it misses the full 'alternatives' part of the rubric.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources