Skip to main content
Glama
Hakolsound

Floors.live MCP Server

by Hakolsound

Floors.live MCP Server

MCP (Model Context Protocol) server for Floors.live — the professional event floorplan designer. Lets AI assistants create events, design floorplans, manage guest lists, and run intelligent seating assignments.

Prerequisites

You need a Floors.live API key. Create one at floors.live/profile under "API Keys" (free account), or via the API:

curl -X POST https://api.floors.live/v1/auth/keys \
  -H "Authorization: Bearer YOUR_FIREBASE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My MCP Key", "scopes": ["events:read","events:write","floorplans:read","floorplans:write","guests:read","guests:write","seating:read","seating:write"]}'

Related MCP server: mmc-mcp

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "floors-live": {
      "command": "npx",
      "args": ["floors-mcp-server"],
      "env": {
        "FLOORS_API_KEY": "flr_sk_YOUR_KEY_HERE"
      }
    }
  }
}

ChatGPT / remote MCP clients

Floors.live also runs a hosted Streamable-HTTP endpoint — no install needed:

https://api.floors.live/mcp

In ChatGPT: Settings → Connectors → Add remote server, paste the URL and use your flr_sk_... key as the Bearer token.

Claude Code

claude mcp add floors-live -- npx floors-mcp-server
# Then set the env variable in your shell:
export FLOORS_API_KEY=flr_sk_YOUR_KEY_HERE

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "floors-live": {
      "command": "npx",
      "args": ["floors-mcp-server"],
      "env": {
        "FLOORS_API_KEY": "flr_sk_YOUR_KEY_HERE"
      }
    }
  }
}

ChatGPT

In ChatGPT, go to Settings > MCP Servers > Add Server and enter:

  • URL: https://api.floors.live/mcp

  • Auth: Bearer token — your API key (flr_sk_YOUR_KEY_HERE)

No setup or self-hosting required — the MCP endpoint is hosted by Floors.live.

HTTP Transport (for web integrations)

FLOORS_API_KEY=flr_sk_YOUR_KEY npx floors-mcp-server --http
# MCP endpoint: http://localhost:3001/mcp

Available Tools (32)

Events

Tool

Description

list_events

List all events

create_event

Create a new event

get_event

Get event details

update_event

Update event fields

delete_event

Delete event and all sub-resources

Floorplans

Tool

Description

list_floorplans

List floorplans for an event

create_floorplan

Create a new empty floorplan

get_floorplan

Get floorplan with all objects

update_floorplan

Update floorplan settings

delete_floorplan

Delete a floorplan

duplicate_floorplan

Copy a floorplan with all objects

get_floorplan_stats

Get seat/table statistics

Objects (Canvas Items)

Tool

Description

list_objects

List all objects on canvas

add_objects

Add tables, stages, walls, etc.

update_object

Move, resize, relabel an object

delete_object

Remove an object

get_object_templates

Browse 35+ object types with defaults

Guests

Tool

Description

list_guests

List all guests

add_guests

Add one or more guests

get_guest

Get guest details

update_guest

Update guest info

delete_guest

Remove a guest

import_guests

Bulk import up to 100 guests

Groups

Tool

Description

list_groups

List guest groups

create_group

Create a group with priority

update_group

Update group settings

delete_group

Delete a group (guests kept)

Relationships

Tool

Description

list_relationships

List seating constraints

create_relationship

Set seat_together/keep_apart/etc.

delete_relationship

Remove a constraint

Seating

Tool

Description

get_seating

Get current seat assignments

replace_seating

Replace all assignments

assign_guest_to_seat

Assign one guest to a seat

unassign_guest

Remove guest from seat

auto_assign_seating

Run intelligent auto-assign algorithm

Export & Sharing

Tool

Description

export_guests

Export guest list (JSON/CSV)

share_floorplan

Generate a share link

Composite

Tool

Description

describe_floorplan

Human-readable layout description

get_event_summary

Full event summary with stats

Example Workflow

Ask your AI assistant:

"Create a wedding event for Sarah & Lior at The Grand Hall on June 15th. Set up a floorplan with 8 round tables of 10 seats each, a stage, a dance floor, and a bar. Then add 80 guests and run the auto-assign seating."

The assistant will use the MCP tools to:

  1. create_event — Create the event

  2. create_floorplan — Create a floorplan

  3. add_objects — Place tables, stage, dance floor, and bar

  4. add_guests — Add all 80 guests

  5. create_group — Organize guests into groups

  6. auto_assign_seating — Run intelligent seating

Environment Variables

Variable

Required

Description

FLOORS_API_KEY

Yes

Your API key (format: flr_sk_...)

FLOORS_API_URL

No

Override API base URL (default: https://api.floors.live/v1)

PORT

No

HTTP transport port (default: 3001)

Rate Limits

  • Base tier: 30 requests/min, 1,000/day

  • Pro tier: 120 requests/min, 10,000/day

  • Write operations cost 2x. Auto-assign costs 5x.

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Hakolsound/floors-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server