Floyd

專為AI代理設計的排程與預約引擎。支援檢查可用時段、保留名額，並透過兩階段預約與無衝突資源管理來確認預約。

你可以用 Floyd 做什麼？

Check available appointment slots — Ask the assistant to find open times for a service using floyd_get_available_slots.
Hold a time slot — Reserve a slot temporarily with floyd_hold_booking before confirming.
Confirm a booking — Finalize a held booking via floyd_confirm_booking after getting your explicit consent.
Cancel a booking — Release a held or confirmed booking using floyd_cancel_booking.
Reschedule a booking — Move an existing booking to a new time with floyd_reschedule_booking.
Retrieve booking details — Look up a booking's status and metadata via floyd_get_booking.

文件

Floyd MCP Server

MCP server that exposes Floyd scheduling and booking tools to AI agents. Built on the Model Context Protocol Streamable HTTP transport.

For full API documentation, see docs.floyd.run.

Tools

Tool	Description
`floyd_get_available_slots`	Check available appointment times for a service
`floyd_hold_booking`	Place a temporary hold on a time slot
`floyd_confirm_booking`	Confirm a held booking (requires explicit user consent)
`floyd_cancel_booking`	Cancel a held or confirmed booking
`floyd_reschedule_booking`	Move a booking to a new time
`floyd_update_booking`	Update a booking's metadata
`floyd_get_booking`	Retrieve booking details and status

Setup

pnpm install

Environment variables

Variable	Required	Default	Description
`FLOYD_BASE_URL`	No	`https://api.floyd.run/v1`	Floyd API base URL
`PORT`	No	`3000`	HTTP server port

Usage

HTTP mode (Streamable HTTP)

pnpm dev

MCP endpoint: POST / Health check: GET /health

Stdio mode

pnpm dev -- --stdio

Authentication

When the Floyd engine requires authentication, connecting agents provide their API key via:

Authorization: Bearer <token> header (preferred)
?token=<value> query parameter

The API key is forwarded to the Floyd engine on each request. If the engine has auth disabled (e.g. self-hosted), no key is needed.

Booking flow

get_available_slots → hold_booking → confirm_booking
                                   ↘ cancel_booking
                                   ↘ reschedule_booking
                                   ↘ update_booking (metadata)

Get slots — query available times, returns signed slotId tokens
Hold — reserve a slot using the slotId (or explicit fields). Creates a booking in held state
Confirm — finalize the booking. Requires userConfirmed: true
Cancel — release a held or confirmed booking
Reschedule — move a booking to a new time, preserving its identity
Update — attach or replace metadata (e.g. party size, special requests)

Development

pnpm test          # run tests
pnpm typecheck     # type-check
pnpm lint          # eslint
pnpm format        # prettier
pnpm build         # bundle with tsup

Production

pnpm build
pnpm start

The server handles SIGTERM/SIGINT for graceful shutdown. HTTP requests to the Floyd API have a 10-second timeout.