Phone Call

Phone Call Capability

Description

Call the user on the phone for real-time voice conversations. Use this when you need input, want to report on completed work, or need to discuss next steps.

Prerequisites

• MCP server from ZeframLou/call-me running
• Telnyx or Twilio account with phone number
• OpenAI API key (for TTS/STT)
• ngrok account for webhook tunneling

Setup: Run /phone-call-setup workflow

When to Use

Use when:

• You've completed a significant task and want to report status
• You need real-time voice input for complex decisions
• A question requires back-and-forth discussion
• You're blocked and need urgent clarification
• You want to celebrate a milestone with the user

Do NOT use for:

• Simple yes/no questions (use text)
• Routine status updates
• Information already provided

Tools

initiate_call

Start a phone call with the user.

• message (string): What you want to say
• Returns: Call ID and user's response

continue_call

Continue an active call.

• call_id (string): From initiate_call
• message (string): Your follow-up

speak_to_user

Speak without waiting for response (for acknowledgments).

• call_id (string): From initiate_call
• message (string): What to say

end_call

End the call gracefully.

• call_id (string): From initiate_call
• message (string): Your goodbye

Examples

Simple:

1. initiate_call: "Hey! I finished the auth system. What's next?"
2. User: "Move to API endpoints"
3. end_call: "Perfect! Starting on API endpoints. Talk soon!"

Multi-turn with long operation:

1. initiate_call: "I finished the migration. What should I work on?"
2. User: "Look up the Stripe docs"
3. speak_to_user: "Sure! Let me search for that..."
4. [Perform search]
5. continue_call: "Found the latest Stripe API docs..."
6. end_call: "I'll implement the new payment methods!"

Best Practices

1. Be conversational and natural
2. Provide context before asking questions
3. Offer clear options for decisions
4. Use speak_to_user before long operations
5. Always end gracefully with next steps