VAPI Setup

VAPI Setup

VAPI supports MCP tool integration, allowing it to automatically discover FlowCaptain's appointment tools.

MCP Configuration

1. Open your VAPI assistant configuration
2. Add an MCP Tool integration
3. Set the URL to:

   https://api.flowcaptain.ai/mcp
   

4. Set the Authorization header:

   Bearer sk_live_your_api_key
   

5. Save — VAPI will discover the available tools automatically

Available Tools

Once connected, VAPI will see these tools:

• check_availability — Takes a natural language query (e.g. "next Monday afternoon") and returns available time slots
• book_appointment — Books an appointment at a specific time with caller details
• cancel_appointment — Cancels an existing appointment by phone number, name, or date
• reschedule_appointment — Moves an existing appointment to a new time

Alternative: REST API

If VAPI's MCP integration doesn't work for your use case, you can also configure individual HTTP tool calls to FlowCaptain's REST endpoints:

• POST https://api.flowcaptain.ai/api/v1/check-availability
• POST https://api.flowcaptain.ai/api/v1/book-appointment
• POST https://api.flowcaptain.ai/api/v1/cancel-appointment
• POST https://api.flowcaptain.ai/api/v1/reschedule-appointment

All endpoints require the Authorization: Bearer sk_live_... header.

Tips

• Make sure the Accept header includes application/json, text/event-stream for MCP requests (VAPI sends this automatically)
• Test the connection by asking your assistant about availability