Floyd MCP Server

What is Floyd?

Floyd is an MCP server that exposes scheduling and booking tools from the Floyd API to AI agents. It uses the Model Context Protocol's Streamable HTTP transport, allowing AI assistants to check available appointment slots, hold, confirm, cancel, reschedule, and update bookings.

How to use Floyd?

Install via pnpm install, then run in HTTP mode with pnpm dev (endpoint: POST /) or in stdio mode with pnpm dev -- --stdio. Set the FLOYD_BASE_URL environment variable (defaults to https://api.floyd.run/v1). Agents provide their API key via an Authorization: Bearer header or a token query parameter.

Key features of Floyd

• Seven booking and scheduling tools for AI agents
• Streamable HTTP and stdio transport modes
• Booking lifecycle: hold, confirm, cancel, reschedule, update
• Signed slotId tokens for secure slot reservations
• Configurable API base URL and server port
• Graceful shutdown on SIGTERM/SIGINT

Use cases of Floyd

• AI assistants scheduling appointments for users
• Automated booking management in customer support workflows
• Self-service rescheduling or cancellation of existing bookings
• Updating booking metadata (e.g., party size, special requests)