Provides a voice-receptionist MCP server built for the Alexa+ (Amazon) track and intended to be driven by a voice agent running on Amazon Bedrock, exposing appointment-booking tools for small businesses. Includes listing services with duration and price, checking free time slots by day/period/professional, booking appointments with conflict and opening-hours validation, cancelling or rescheduling a client's appointment, and generating an owner-facing daily summary with clients, expected revenue, and next appointment — each response returning a short spoken phrase plus structured data, with natural-language date/time parsing (e.g. "sexta de manhã", "9h30").
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Front Desk quero cortar o cabelo sexta de manhã"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Recepcionista por voz para pequenos negócios, construída como servidor MCP para a trilha Alexa+ do Build, Ship, Shape: Amazon Developer Hackathon.
O cliente fala "quero cortar o cabelo sexta de manhã", o servidor confere a agenda, marca o horário e o painel do dono atualiza na hora.
Ferramenta | O que faz | Exemplo de fala |
| Serviços, duração e preço | "Quanto custa o corte?" |
| Horários livres por dia, período e profissional | "Tem horário sexta de manhã?" |
| Marca o horário, checando funcionamento e conflitos | "Marca um corte sexta às 9h para o João" |
| Cancela o próximo horário do cliente | "Cancela o meu horário" |
| Muda dia ou hora, mantendo o profissional quando possível | "Passa para as 16h" |
| Resumo para o dono: clientes, receita prevista, próximo atendimento | "Como está minha agenda hoje?" |
Toda resposta traz um campo fala, com a frase curta que o assistente de voz deve dizer, e os dados estruturados.
O servidor entende datas como "hoje", "amanhã", "sexta" e "23/10", e horários como "9h", "9h30" e "14:00".
Também há GET /api/agenda?data=AAAA-MM-DD, com a agenda do dia em JSON para o painel do dono.
Related MCP server: OpenBook
Servidor MCP em POST /mcp (Streamable HTTP, MCP spec 2025-11-25)
Agenda em SQLite com dados de uma barbearia fictícia
As seis ferramentas de agenda, com testes
Simulador de voz com agente no Amazon Bedrock
Painel do dono ao vivo
Requer Python 3.10 ou superior.
python -m venv .venv
# Windows: .venv\Scripts\activate macOS/Linux: source .venv/bin/activate
pip install -r requirements.txt
python -m frontdesk.serverO servidor sobe em http://127.0.0.1:8000/mcp e a verificação de saúde em http://127.0.0.1:8000/health.
Variáveis opcionais:
FRONTDESK_DB: caminho do banco SQLite (padrão: frontdesk.db na raiz).
FRONTDESK_DEMO=0: não cria os agendamentos de exemplo.
FRONTDESK_AGORA=2026-10-23T08:00: fixa o relógio, útil para gravar a demo.
python -m pytest -qPara inspecionar com o MCP Inspector, conecte em http://127.0.0.1:8000/mcp usando o transporte Streamable HTTP.
MIT
This server cannot be deployed
Manage an EasyWeek business from AI: bookings, availability, customers, services, orders, messaging.
Answer small-business customer questions from FAQs, list open appointment times, and book them.
Verified local businesses, bookable by AI agents: services, prices, availability and appointments.
AI phone receptionist for small businesses: read calls, leads and booked appointments.
