Skip to main content
Glama

get_dialer_report

Read-only

Campaign report: released, answered, human, machine, no answer, busy, failed counts, outcomes, budget, cost split and cost per connect.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "campaign_id": "<campaign_id>",
      "purpose": "<purpose>"
    },
    "name": "get_dialer_report"
  }
}

Input Schema

NameRequiredDescriptionDefault
purposeYesRequired on tools that read data or reports; recommended on every tool. One sentence: what you are doing and why (for example "finding this caller's open ticket to answer them"). Building a report, dashboard, analytics or an export is a SautiDesk Pro feature done by the report tools, not by pulling records.
campaign_idYescampaign UUID

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is covered. The description adds the metric inventory, effectively disclosing the return payload in the absence of an output schema, but says nothing about the reporting window, whether figures are cumulative or time-bounded, or how fresh the data is — the one behavioral trait that matters most for a report tool.

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?

A single compact sentence that front-loads the scope word 'Campaign report:' and then lists payload fields; nothing is redundant. It loses a point for being a verbless fragment whose metric terms ('released', 'human', 'machine') are domain jargon not glossed anywhere.

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?

As a read-only tool with two fully documented parameters and no output schema, the metric enumeration does much of the work an output schema would. Still missing is any statement of time window/aggregation and any differentiation from nearby report and live-view siblings, which leaves a real ambiguity for an agent choosing among them.

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% for both parameters, and the purpose parameter carries substantial inline guidance, so the baseline is 3. The description itself contributes nothing about campaign_id or purpose, adding no meaning beyond the schema.

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 names the resource (a dialer campaign report) and enumerates the exact metrics it returns — released, answered, human, machine, no answer, busy, failed, outcomes, budget, cost split, cost per connect — so an agent knows quite precisely what data it gets. It is a noun phrase with no verb and never explicitly contrasts with get_dialer_live, get_dialer_campaign or get_call_stats, so distinction from siblings is left to inference.

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?

There is no when-to-use statement, no exclusion or alternative named, and no mention of prerequisites (e.g. whether the campaign must have run or be active). The only guidance an agent can infer is that this is a reporting read on a campaign rather than a live view.

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