# Epiphany MCP Server

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

## Setup

1. **Install dependencies**:
   ```bash
   npm install
   ```

2. **Set API key**:
   ```bash
   export EPIPHANY_API_KEY="ep_your_api_key_here"
   ```

3. **Add to Claude Desktop config** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
   ```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**

## 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