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: Agentic AI MCP Server

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"
      }
    }
  }
}

Smithery (one-click install)

smithery.ai/server/ronp/floors-live — install into Claude, ChatGPT, Windsurf, or Cursor from the Smithery gateway; paste your flr_sk_... key when prompted.

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

Floorplans

Objects (Canvas Items)

Guests

Groups

Relationships

Seating

Export & Sharing

Composite

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

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.

Links

• Floors.live

• API Documentation

• Sign Up