Skip to main content
Glama

Place a call

request_call

Rings the user's phones. After one answers, dials the destination into that same conversation. The result shows as an outgoing phone call. The user speaks on it. Pro plan. If no phone answers, the destination is not dialled.

Input Schema

NameRequiredDescriptionDefault
destinationNoPhone number to connect after the user answers.
identity_idNoOptional. You may set it. If you omit it, Widely picks the caller ID. If you set it, it must be an identity_id from list_identities, one of the user's own. Never invent another number. A grant limited to several numbers still needs identity_id.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / identity_id / description
      Previous value: -"Optional identity id. Omit it and Widely picks the caller ID the same way the app does. Needed only when the grant is limited to several numbers."New value: +"Optional. You may set it. If you omit it, Widely picks the caller ID. If you set it, it must be an identity_id from list_identities, one of the user's own. Never invent another number. A grant limited to several numbers still needs identity_id."
  2. Changed1 schema field changed
    • changedInput schema / properties / identity_id / description
      Previous value: -"Optional identity id to call from. Omit it and Widely picks the caller ID the same way as a call from the app. Needed only when the grant is limited to several numbers."New value: +"Optional identity id. Omit it and Widely picks the caller ID the same way the app does. Needed only when the grant is limited to several numbers."
  3. Changed1 schema field changed
    • changedInput schema / properties / identity_id / description
      Previous value: -"Optional identity id when the grant is limited to specific numbers."New value: +"Optional identity id to call from. Omit it and Widely picks the caller ID the same way as a call from the app. Needed only when the grant is limited to several numbers."
  4. Changed1 schema field changed
    • changedInput schema / properties / identity_id / description
      Previous value: -"Optional identity from list_identities, when the grant is limited to specific numbers."New value: +"Optional identity id when the grant is limited to specific numbers."
  5. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Beyond the annotations, the description discloses the ringing sequence, wait-for-answer behavior, the same-conversation dialing, the resulting outgoing call, and that no destination is dialed if no phone answers. The annotations already cover safety and openness, so this is solid added context. It does not mention rate limits, billing, or concurrent-call behavior.

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 short and front-loads the key action. Every sentence conveys useful behavior, though the fragment 'Pro plan.' and the standalone 'The user speaks on it.' make the structure slightly choppy.

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?

For a two-parameter tool with no output schema, the description covers the call flow, plan requirement, and no-answer behavior sufficiently. The schema handles identity_id details. It could be stronger by clarifying how this relates to call tasks or what happens if the user is already on a call.

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 both parameters are already fully documented in the input schema. The description adds no parameter-specific meaning, such as identity_id constraints or destination format, beyond what the schema provides. Baseline 3 is appropriate when the schema does the heavy lifting.

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 states a specific two-stage action: it rings the user's phones first, then dials the destination into that same conversation. This distinguishes the tool from generic calling tools by describing the bridging flow. It does not explicitly name or contrast with siblings such as create_call_task, so it falls short of a 5.

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?

It notes the Pro plan prerequisite and the no-answer outcome, which gives useful context. However, it never says when to choose this tool over alternatives like create_call_task, request_speak, or other call-related siblings, leaving the routing decision implicit.

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.