Skip to main content
Glama

cars_session_notify

Set the buyer's email notification preference for this session. Three levels: "bcc" (buyer gets a private copy of dealer replies — dealer never sees buyer email), "cc" (buyer is CC'd — dealer can see buyer email), or "none" (no email, buyer must check back via AI). This upgrades the session identity level to "email".

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
modeNoNotification mode: "bcc" (private), "cc" (visible to dealer), or "none"bcc
emailNoBuyer's email address
sessionYesSession hash
agent_idNoYour agent identifier

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / required
      Previous value: -[
      -  "session",
      -  "email"
      -]New value: +[
      +  "session"
      +]
  2. First observed

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations provided, the description carries the full behavioral disclosure burden and does well: it explains the privacy semantics of each mode (dealer never sees buyer email in bcc vs. sees it in cc) and discloses a non-obvious side effect — 'This upgrades the session identity level to email.' It stops short of covering failure states or prerequisites, but the disclosed traits go meaningfully beyond the schema.

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

Conciseness5/5

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

Three sentences with zero waste: the purpose is front-loaded in sentence one, the mode semantics are compressed into sentence two, and the side effect is stated in sentence three. Every sentence earns its place and the most decision-relevant information appears first.

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?

Complete enough for a simple preference-setting tool with no output schema: purpose, mode semantics, and side effect are all covered. The main gap is the conditional relationship between mode and the email parameter — it is never stated whether email is required for bcc/cc but not none — and error conditions are unaddressed. Minor omissions given the tool's simplicity.

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 coverage is 100%, which sets a baseline of 3, but the description adds genuine value by defining the behavioral meaning of each mode value: bcc as private copy with dealer blind, cc as visible to dealer, and none as requiring the buyer to check back via AI. The schema's parenthetical labels are terse; the description supplies the operational semantics an agent needs to choose correctly.

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?

States a specific verb+resource ('Set the buyer's email notification preference for this session') and fully explains the three modes. It is clearly distinct from sibling tools like cars_session_message, cars_session_reply, and cars_session_read, which handle messaging rather than notification preference configuration.

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

Usage Guidelines3/5

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

The intended usage is implied by the purpose — call when you need to set or change the email notification mode for a session — but there are no explicit when-to-use conditions, exclusions, or named alternatives. It does not say, for example, when to use this instead of cars_session_message or how this relates to the interest/deal flow.

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