Get call result
get_callGet the status, duration, summary, collected data and transcript of a call placed with make_call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| call_id | Yes | The call_id returned by make_call |
get_callGet the status, duration, summary, collected data and transcript of a call placed with make_call.
| Name | Required | Description | Default |
|---|---|---|---|
| call_id | Yes | The call_id returned by make_call |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, and destructiveHint=false, so the safety profile is covered structurally. The description usefully enumerates what data comes back, but says nothing about whether status can be pending/in-progress (i.e., whether polling is required) or about latency/rate limits, which is the main behavioral unknown for a result-fetching tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler; every clause maps to a concrete piece of returned data or the call_id provenance.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, the description carries the burden of describing return values and does so by listing the fields. The remaining gap is lifecycle context (what status values exist, whether a result may be incomplete), which is minor for a simple getter but would have made it fully self-sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and the single call_id parameter is fully documented in the schema, including its origin ('returned by make_call'). The description restates that provenance but adds no syntax, format, or error semantics beyond the schema, so the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Names a specific verb (Get) and resource (a call) and enumerates the fields returned: status, duration, summary, collected data, transcript. The phrase 'a call placed with make_call' scopes it to a single call, which implicitly distinguishes it from the sibling list_calls.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
By tying call_id to 'returned by make_call,' it implies the call sequence (create with make_call, then retrieve with get_call). However, it never explicitly states when to use this instead of list_calls, nor does it mention whether repeated polling is expected while a call is in progress.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.