restaurant-ai-mcp
stefanogebara/restaurant-ai-mcp
AI Restaurant Phone Receptionist MCP Server - Handles reservations via ElevenLabs voice agent
Instalação
npx convez-ai stefanogebara/restaurant-ai-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Seatable - AI Restaurant Management Platform
AI-powered restaurant management platform that handles reservations 24/7 through ElevenLabs voice agents.
Features
- ✅ Check availability in real-time
- ✅ Create reservations automatically
- ✅ Lookup existing reservations
- ✅ Modify reservation details
- ✅ Cancel reservations
- ✅ Provide wait time estimates
API Endpoints
All endpoints accept both GET and POST requests with JSON body or query parameters.
1. Check Availability
POST /check-availability
{
"date": "2025-10-15",
"time": "19:00",
"party_size": 4
}
2. Create Reservation
POST /create-reservation
{
"date": "2025-10-15",
"time": "19:00",
"party_size": 4,
"customer_name": "John Smith",
"customer_phone": "+15551234567",
"customer_email": "john@example.com",
"special_requests": "Window seat"
}
3. Lookup Reservation
POST /lookup-reservation
{
"phone": "555-1234"
}
OR
{
"name": "Smith"
}
4. Modify Reservation
POST /modify-reservation
{
"reservation_id": "RES-20251015-1234",
"new_time": "20:00",
"new_party_size": 6
}
5. Cancel Reservation
POST /cancel-reservation
{
"reservation_id": "RES-20251015-1234"
}
6. Get Wait Time
POST /get-wait-time
{}
Tech Stack
- Runtime: Node.js (Vercel Serverless Functions)
- Database: Supabase PostgreSQL (migrated from Airtable on Nov 1, 2025)
- Voice AI: ElevenLabs Conversational AI
- Frontend: React 18 + TypeScript + Vite
- Deployment: Vercel
Deployment
# Install dependencies
npm install
# Deploy to Vercel
vercel --prod
Environment Variables
Set these in Vercel dashboard or .env:
Required (Supabase PostgreSQL)
SUPABASE_URL- Your Supabase project URLSUPABASE_ANON_KEY- Supabase anonymous/public keySUPABASE_SERVICE_ROLE_KEY- (Optional) For admin operations
AI Services
ANTHROPIC_API_KEY- Claude AI API keyOPENAI_API_KEY- OpenAI API key (fallback)ELEVENLABS_API_KEY- ElevenLabs voice AI key
Legacy (Deprecated Nov 1, 2025)
AIRTABLE_API_KEY- No longer usedAIRTABLE_BASE_ID- No longer usedRESERVATIONS_TABLE_ID- No longer usedRESTAURANT_INFO_TABLE_ID- No longer used
Database Schema
Supabase PostgreSQL (8 Tables)
Project URL: https://lurebwaudisfilhuhmnj.supabase.co
- restaurant_info - Restaurant configuration
- tables - Physical table inventory
- reservations - Customer reservations
- service_records - Active dining sessions
- waitlist - Waitlist management
- customer_history - Historical behavior tracking
- ml_interventions - ML ROI tracking (Target: 300-500% ROI)
- subscriptions - Stripe subscription tracking
See CLAUDE.md for detailed schema documentation or visit the Supabase Dashboard.
Created
October 2025 - AI Restaurant Receptionist System