Title99/100
Account Overview
The title clearly communicates the tool’s action and subject. Keep it concise.
Description80/100
Get a complete snapshot of your AgentPhone account: agents, phone numbers, webhook status, and usage limits.
The description explains the capability, when to use it, and what to expect.
Inputs100/100
This tool declares no inputs, so argument descriptions are not needed.
No input fields.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema85/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"usage": {
"anyOf": [
{
"type": "object",
"properties": {
"used": {
"type": "number",
"description": "Phone numbers currently provisioned."
},
"limit": {
"type": "number",
"description": "Maximum numbers allowed."
},
"remaining": {
"type": "number",
"description": "Numbers still available to provision."
}
},
"description": "Phone-number usage against the account limit.",
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Phone-number usage; omitted if the lookup failed."
},
"agents": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The agent's unique ID (use as agent_id elsewhere)."
},
"name": {
"type": "string",
"description": "Human-readable agent name."
},
"voice": {
"type": "string",
"description": "Voice ID the agent speaks with."
},
"numbers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The phone number's ID."
},
"status": {
"type": "string",
"description": "Service status of the number."
},
"phoneNumber": {
"type": "string",
"description": "The number in E.164 format."
}
},
"description": "A phone number attached to the agent.",
"additionalProperties": {}
},
"description": "Phone numbers attached to this agent."
},
"sttMode": {
"type": "string",
"description": "Speech-to-text mode: fast or accurate."
},
"language": {
"type": "string",
"description": "BCP-47 locale for speech, e.g. en-US."
},
"createdAt": {
"type": "string",
"description": "When the agent was created (ISO 8601)."
},
"modelTier": {
"type": "string",
"description": "Model quality/speed tier: turbo, balanced, max, or realtime."
},
"voiceMode": {
"type": "string",
"description": "'webhook' (your backend drives calls) or 'hosted' (built-in AI)."
},
"voiceSpeed": {
"type": "number",
"description": "Speech rate multiplier (1 = normal)."
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Free-text note about the agent's purpose."
},
"ambientSound": {
"type": "string",
"description": "Background ambience played on calls."
},
"beginMessage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Opening line the hosted AI speaks, or null."
},
"maxSilenceMs": {
"type": "number",
"description": "Milliseconds of caller silence before the call ends."
},
"systemPrompt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Instructions for the hosted AI on calls, or null."
},
"denoisingMode": {
"type": "string",
"description": "Audio denoising mode applied to calls."
},
"transferNumber": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "E.164 number calls transfer to, or null if disabled."
},
"enableMessaging": {
"type": "boolean",
"description": "Whether the hosted agent can send/read texts mid-call."
},
"voicemailMessage": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Voicemail greeting text, or null if disabled."
},
"enableBackchannel": {
"type": "boolean",
"description": "Whether the agent interjects 'mhmm' while the caller speaks."
},
"interruptionSensitivity": {
"type": "number",
"description": "How readily the agent lets a caller interrupt (0-1)."
}
},
"description": "An AgentPhone agent and its configuration.",
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The account's agents (omitted if the lookup failed)."
},
"numbers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The phone number's unique ID (use as number_id elsewhere)."
},
"status": {
"type": "string",
"description": "Provisioning/service status of the number."
},
"agentId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "ID of the agent this number is assigned to, or null if unassigned."
},
"country": {
"type": "string",
"description": "ISO country code the number belongs to."
},
"createdAt": {
"type": "string",
"description": "When the number was provisioned (ISO 8601)."
},
"phoneNumber": {
"type": "string",
"description": "The number in E.164 format, e.g. +14155550123."
}
},
"description": "A phone number in the account.",
"additionalProperties": {}
}
},
{
"type": "null"
}
],
"description": "The account's phone numbers (omitted if the lookup failed)."
},
"webhook": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Project webhook URL."
},
"status": {
"type": "string",
"description": "Project webhook status."
}
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "Project-level webhook summary; null if none is configured, omitted if the lookup failed."
},
"recentActivity": {
"type": "object",
"properties": {
"callsLast30d": {
"type": "number",
"description": "Calls in the last 30 days."
},
"messagesLast30d": {
"type": "number",
"description": "Messages in the last 30 days."
}
},
"description": "Recent 30-day activity totals.",
"additionalProperties": {}
}
},
"description": "Snapshot of the account: usage, agents, numbers, webhook, and recent activity.",
"additionalProperties": {}
}