Skip to main content
Glama
floyd-run

Floyd

by floyd-run
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Floyd MCP Server

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

For the engine's API documentation, see the docs folder in the engine repo.

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

Related MCP server: @astrocal/mcp-server

Setup

pnpm install

Environment variables

Variable

Required

Default

Description

FLOYD_BASE_URL

No

http://localhost:4000/v1

Floyd Engine 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:

  1. Authorization: Bearer <token> header (preferred)

  2. ?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)

  1. Get slots — query available times, returns signed slotId tokens

  2. Hold — reserve a slot using the slotId (or explicit fields). Creates a booking in held state

  3. Confirm — finalize the booking. Requires userConfirmed: true

  4. Cancel — release a held or confirmed booking

  5. Reschedule — move a booking to a new time, preserving its identity

  6. 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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Chronary by Chronary

    Chronaryofficial

    Chronary
    A
    license
    A
    quality
    A
    maintenance
    Calendar API purpose-built for AI agents. Exposes tools to manage agents, calendars, and events, find meeting times, run scheduling proposals, set availability rules, manage webhooks, and subscribe to iCal feeds.
    54
    65 npm
    Apache 2.0

  • @astrocal/mcp-server

    astrocal-dev
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to schedule meetings via Astrocal's scheduling API, including checking availability, booking, canceling, rescheduling, and managing waitlists through natural conversation.
    45 npm
    1
    MIT

  • expert-booking-mcp

    Dante-dan
    -
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to discover and invoke expert booking tools via a Streamable HTTP MCP server, supporting slot search, holds, payments, and human-in-the-loop confirmations with strict validation and time-based contracts.
    -

  • G-Guest MCP server

    BlondeDevRules
    A
    license
    A
    quality
    A
    maintenance
    Book a table, an appointment or a place in a class at a real local business. Live availability, instant confirmation, no account and no API key. Eight tools: search, fetch, get_business, check_availability, create_booking, check_booking, cancel_booking and request_listing. Guest emails in eight languages. Hosted at https://g-guest.app/api/mcp
    8
    10 npm
    MIT