Epiphany MCP Server

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

Setup

1. Install dependencies:

   npm install

2. Set API key:

   export EPIPHANY_API_KEY="ep_your_api_key_here"

3. 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"
         }
       }
     }
   }

4. Restart Claude Desktop

Related MCP server: @aiwerk/mcp-server-cal

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