@floom-dev/mcp-server

@floom-dev/mcp-server

MCP server for Floom. Lets AI agents (Claude, Cursor) deploy and run Python apps.

Setup

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "floom": {
      "command": "npx",
      "args": ["@floom-dev/mcp-server"],
      "env": {
        "FLOOM_URL": "http://localhost:3001",
        "FLOOM_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to MCP settings with the same command and environment variables.

Tools

The server exposes 18 tools for AI agents:

Deploy and Run

• deploy - Deploy Python code with optional config and requirements
• run - Execute an endpoint (auto-polls until result)
• list_projects - List all deployed apps
• get_project - Get app details and endpoint schemas

Version Management

• list_versions - Show dev/prod versions
• promote - Promote with health check and auto-rollback
• rollback - Rollback to a previous version

Secrets

• manage_secrets - List, set, or delete API keys (action param)

Storage

• storage_set / storage_get / storage_delete / storage_list - Persistent key-value store

Share Links

• create_share_link / list_share_links / disable_share_link - Public link management

Context

• fetch_context / list_contexts / delete_context - Attach external data sources

Logs

• get_logs - Recent run logs with error details and suggested fixes

Environment Variables

Variable	Required	Description
FLOOM_URL	Yes	Floom server URL
FLOOM_API_KEY	No	API key (optional in OSS mode)

License

MIT