Epiphany MCP

Epiphany MCP Server

MCP server for Epiphany booking automation - enables AI agents to check availability and create bookings.

Setup

1. Install dependencies:

   npm install

1. Set API key:

   export EPIPHANY_API_KEY="ep_your_api_key_here"

1. Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

   {
     "mcpServers": {
       "epiphany": {
         "command": "node",
         "args": ["/path/to/epiphany-mcp-server.js"],
         "env": {
           "EPIPHANY_API_KEY": "ep_your_api_key_here"
         }
       }
     }
   }

1. Restart Claude Desktop

Tools Available

• list_vsls - Get all your VSLs
• get_vsl - Get VSL details + time slots
• get_available_times - Check availability for a date
• create_booking - Book a time slot
• list_bookings - View all bookings
• get_booking - Get specific booking details
• get_waitlist - Get waitlist entries

FreightPhone Integration

For embedding in FreightPhone website agent:

1. Use epiphany-agent-context.md as system prompt
2. Add VSL ID to environment variables
3. Agent flow: qualify → check times → collect info → book → confirm

Rate Limits

• 100 requests/minute
• 1000 requests/hour

Error Handling

All errors return structured messages. Common issues:

• Invalid VSL ID
• Time slot already booked
• Missing required fields
• Invalid date/time format