Call Me

Get call result

poll_result

Read-onlyIdempotent

Check on a call that came back "ringing", "in_call" or "playing". Waits up to ~25s for it to settle, then returns the same shape as call: the final status and transcript once they answer, decline, or the ring times out ("missed", within about a minute). Still not settled: call it again. For play_audio calls it reports listened_s and finished. Rings nothing.

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": {
      "call_id": "<call_id>",
      "session_token": "<session_token>"
    },
    "name": "poll_result"
  }
}

Input Schema

Name	Required	Description	Default
`call_id`	Yes	The call_id from the call or play_audio result.
`session_token`	Yes	The session_token from an earlier result. It keeps every call and text in one thread on their phone.

Output Schema

Name	Required	Description
`from`	No	Your own agent number. Never call or text it.
`next`	No	What to do next when the call has not settled.
`open`	No	True while the line stays up for say or hang_up.
`turn`	No	Index of the answer within a conversation.
`title`	No	play_audio: the recording's title.
`status`	Yes	"completed" (answered), "ringing" or "in_call" (not settled: poll_result), "missed", "declined", "ended", "hanging_up", "playing" (play_audio), or "setup_required" when no number was given.
`call_id`	No	Pass to poll_result, say and hang_up.
`audio_id`	No	play_audio: the recording that was offered.
`finished`	No	play_audio: whether they heard it to the end.
`language`	No	Language code the recognizer heard, information only.
`listened`	No	play_audio: whether they chose to listen.
`duration_s`	No	play_audio: its length in seconds.
`listened_s`	No	play_audio: seconds they listened.
`transcript`	No	What the human said; empty if they only listened.
`audio_error`	No	play_audio: why the recording could not be played.
`language_name`	No	That language's name.
`session_token`	No	Reuse in later calls and texts to stay in one thread.
`said_while_waiting`	No	What they said while you were thinking.

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedNov 4, 2026

addedInput schema / properties / call_id / description

Added value: +"The call_id from the call or play_audio result."

addedInput schema / properties / session_token / description

Added value: +"The session_token from an earlier result. It keeps every call and text in one thread on their phone."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "audio_error": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "play_audio: why the recording could not be played.",
+      "title": "Audio Error"
+    },
+    "audio_id": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "play_audio: the recording that was offered.",
+      "title": "Audio Id"
+    },
+    "call_id": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Pass to poll_result, say and hang_up.",
+      "title": "Call Id"
+    },
+    "duration_s": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "play_audio: its length in seconds.",
+      "title": "Duration S"
+    },
+    "finished": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "play_audio: whether they heard it to the end.",
+      "title": "Finished"
+    },
+    "from": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Your own agent number. Never call or text it.",
+      "title": "From"
+    },
+    "language": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Language code the recognizer heard, information only.",
+      "title": "Language"
+    },
+    "language_name": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "That language's name.",
+      "title": "Language Name"
+    },
+    "listened": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "play_audio: whether they chose to listen.",
+      "title": "Listened"
+    },
+    "listened_s": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "play_audio: seconds they listened.",
+      "title": "Listened S"
+    },
+    "next": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "What to do next when the call has not settled.",
+      "title": "Next"
+    },
+    "open": {
+      "anyOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "True while the line stays up for say or hang_up.",
+      "title": "Open"
+    },
+    "said_while_waiting": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "What they said while you were thinking.",
+      "title": "Said While Waiting"
+    },
+    "session_token": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Reuse in later calls and texts to stay in one thread.",
+      "title": "Session Token"
+    },
+    "status": {
+      "description": "\"completed\" (answered), \"ringing\" or \"in_call\" (not settled: poll_result), \"missed\", \"declined\", \"ended\", \"hanging_up\", \"playing\" (play_audio), or \"setup_required\" when no number was given.",
+      "title": "Status",
+      "type": "string"
+    },
+    "title": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "play_audio: the recording's title.",
+      "title": "Title"
+    },
+    "transcript": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "What the human said; empty if they only listened.",
+      "title": "Transcript"
+    },
+    "turn": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "description": "Index of the answer within a conversation.",
+      "title": "Turn"
+    }
+  },
+  "required": [
+    "status"
+  ],
+  "title": "CallResult",
+  "type": "object"
+}

First observedOct 4, 2026

TDQS

A4.4/5.0

Behavior5/5

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

Goes well beyond the readOnly/idempotent annotations: discloses the ~25s blocking wait, the timeout-to-'missed' window of about a minute, that the return shape mirrors `call`, and that play_audio calls additionally report listened_s and finished. 'Rings nothing' explicitly reassures that polling has no side effect on the callee's phone, which annotations alone cannot convey.

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?

Front-loads the trigger condition, then the timing behavior, then the return shape, then the retry rule - a sensible order with little waste. The phrasing is slightly compressed ('Rings nothing', quoted statuses inline) but nothing is padded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a blocking poll tool, the agent needs wait duration, terminal statuses, retry policy, and return shape - all present, and an output schema covers the payload structure. Nothing material is missing.

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%, with both call_id and session_token fully documented in the schema, including where to obtain them. The description adds no syntax or format detail beyond that, so it sits at the baseline.

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?

Names a specific verb and resource (poll the result of a call) and pins the exact precondition states - 'ringing', 'in_call', 'playing' - that distinguish it from the initiating sibling `call`. An agent can tell immediately that this is the follow-up read, not the initiator.

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?

Gives clear when-to-use context (only for calls already in a ringing/in-call/playing state) and explicit loop guidance: 'Still not settled: call it again.' It does not explicitly name hang_up or say when to give up entirely, so it falls just short of full alternative routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Call Me tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.