retell_get_phone_number
Retrieve details for a specific phone number in E.164 format to verify availability, check configuration, or manage AI agent connections.
Instructions
Retrieve details of a specific phone number.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone_number | Yes | The phone number in E.164 format to retrieve |
Implementation Reference
- src/index.ts:1155-1156 (handler)Handler case in executeTool switch that performs a GET request to the Retell API endpoint /get-phone-number/{phone_number} using the retellRequest helper.case "retell_get_phone_number": return retellRequest(`/get-phone-number/${encodeURIComponent(args.phone_number as string)}`, "GET");
- src/index.ts:339-352 (schema)Tool schema definition including name, description, and input schema requiring 'phone_number' string in E.164 format.{ name: "retell_get_phone_number", description: "Retrieve details of a specific phone number.", inputSchema: { type: "object", properties: { phone_number: { type: "string", description: "The phone number in E.164 format to retrieve" } }, required: ["phone_number"] } },
- src/index.ts:1283-1285 (registration)Registration of the tool list handler that returns the full tools array containing the schema for retell_get_phone_number.server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools }; });
- src/index.ts:1288-1293 (registration)MCP server request handler for tool execution that dispatches to executeTool based on tool name, effectively registering all tools including retell_get_phone_number.server.setRequestHandler(CallToolRequestSchema, async (request) => { const { name, arguments: args } = request.params; try { const result = await executeTool(name, args as Record<string, unknown>); return {