Skip to main content
Glama

geo360_b2a_price_context

PHASE 1 B2A: Returns structured price context for critical commodities and raw materials (LME/Platts-style spot benchmarks) with strict quote TTL. Evaluates price awareness before publishing an RFQ tender. Does not execute trade settlement.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
sub_idNoCalling agent user reference for tracking and attribution
currencyNoSettlement currency referenceEUR
verticalNoIndustrial commodity verticalMETALLURGY
agent_refNoCalling agent identity (e.g. 'SAP_Procurement_Agent', 'Grok_Buyer')
session_idNoSession UUID for multi-turn state coordination
material_specYesPrecise material classification (e.g. 'EN-AW-6082-T6', 'CU-ETP', 'HDPE-INJ-BLOW')
quantity_metric_tonsYesOrder volume in metric tons (e.g. 50.0)

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior3/5

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

With no annotations, the description carries the full burden. It usefully discloses 'strict quote TTL' and that settlement is out of scope, but says nothing about permissions, idempotency, or the read-only nature beyond implication. Adequate but not rich.

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?

Three front-loaded sentences with the phase tag first, and every sentence carries content (purpose, usage condition, boundary). No filler, though 'PHASE 1 B2A' jargon is not self-explanatory.

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?

No output schema and no annotations, so the description should do more to describe the returned 'structured price context' (fields, TTL semantics). It covers purpose and a boundary but leaves the return shape and failure behavior unspecified.

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

Parameters3/5

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

Schema description coverage is 100%, so all 7 parameters are already documented in the schema. The description adds no parameter-level meaning (nor syntax for material_spec or TTL relationship), so the baseline 3 applies.

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?

States a specific verb and resource ('Returns structured price context for critical commodities and raw materials') with the benchmark style (LME/Platts) called out. It does not name a specific sibling, though 'before publishing an RFQ tender' loosely ties it to the RFQ tool.

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 clear context for when to invoke it ('Evaluates price awareness before publishing an RFQ tender') and a hard boundary ('Does not execute trade settlement'). It stops short of explicitly naming the alternative tool to use for settlement, so no full when/when-not/alternative triad.

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