Floom
@floomhq
About Floom
No overview available yet
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"floom": {
"command": "npx",
"args": [
"-y",
"@floomhq/mcp-server"
]
}
}
}Tools
32Deploy Python code to Floom and get a usable URL. Accepts raw Python source or a base64-encoded ZIP. Optionally include a floom.yaml config to declare endpoint schemas, secrets, and resource requirements. If your code makes HTTP requests (requests, httpx, urllib), set config.network to true. Without it, outbound network access is blocked.
Execute an action on a deployed Floom app. Returns the function output as JSON. Preferred: use app_slug + action for simple invocation. Alternative: use project_id + endpoint_id + version_id for explicit control. Pass secrets: {KEY: value} for functions that require API keys.
List all deployed Floom projects.
Get details for a Floom project including endpoint schemas and input parameters. Use this before calling run to see what inputs an endpoint expects.
Manage persistent secrets (API keys, tokens) for a Floom project. Available across all runs. Supports list, set, and delete operations. For one-time secrets, use the secrets parameter on the run tool instead.
Get recent run logs for a Floom project.
List all versions of a Floom project. Shows which version is dev (latest deploy) and which is prod (promoted).
Promote a version to production. By default promotes the current dev version. Runs a health check; auto-rolls back if the check fails.
Rollback production to a previous version.
Store a persistent key-value pair for a Floom project. Values persist across runs and deploys.
Retrieve a stored value for a Floom project.
Delete a stored value for a Floom project.
List all stored keys for a Floom project with usage info.
Create a public share link for a Floom endpoint. Share links allow anyone to run the endpoint without authentication.
List all share links for a Floom project.
Disable a share link for a Floom project. The link will no longer be accessible.
Fetch external data from a URL and attach it as context to a Floom project. Context data enhances AI-powered endpoints.
List all context entries for a Floom project.
Remove a context entry from a Floom project.
Delete a Floom project and all its data (versions, runs, secrets, storage).
Update a Floom project name or slug.
Deploy a Floom app directly from a GitHub repository URL.
List available starter templates for Floom projects.
Get details and code preview for a Floom starter template.
Create a new Floom project from a starter template.
Retrieve stored context data for a Floom project.
Re-fetch context data from its source URL.
Create a cron schedule that automatically runs an endpoint at specified intervals.
List all cron schedules for a Floom project.
Delete a cron schedule from a Floom project.
Enable public inbound webhooks for a Floom project. Once enabled, external services can trigger runs via POST /v1/webhooks/:slug/:action without authentication.
Disable public inbound webhooks for a Floom project.
Overview
What is Floom?
Floom is an open‑source protocol and runtime for agentic work. It turns an OpenAPI specification into three surfaces: a shareable web form, an MCP server that an agent can call, and an HTTP API endpoint — all with built‑in auth, rate limits, secret injection, and run history.
How to use Floom?
Point Floom at an OpenAPI spec URL. For the cloud version, sign in at floom.dev and publish via the build page. For self‑hosting, create an apps.yaml manifest and run the official Docker image with docker run; the manifest defines proxied (wrapping an existing API) or hosted (Floom runs your container) modes. Every published app is immediately available as a web form at /p/:slug, an MCP endpoint at /mcp/app/:slug, and an HTTP endpoint at /api/:slug/run.
Key features of Floom
- One manifest generates a web form, MCP server, and HTTP API.
- Proxied mode wraps any existing API; hosted mode runs your Docker container.
- Built‑in Bearer/API‑key auth, per‑operation rate limits, and secret injection.
- Every app exposes MCP tools; four MCP admin tools let an agent add new apps.
- Shareable result URLs and run history are included out of the box.
Use cases of Floom
- Vibecoder creators – paste an OpenAPI URL and instantly publish a shareable web form plus an MCP tool for friends.
- Biz users – wrap an internal API (e.g. Stripe) in a form for ops teams, with logged runs and clean output rendering.
- Agent development – use Floom’s MCP server so an AI agent can call your API without custom glue code.
- Self‑hosted API gateways – run Floom in Docker to manage rate limits, auth, and logs for your own services.
FAQ from Floom
What input formats does Floom support?
Floom accepts an OpenAPI specification (URL or local file). It reads each operation and automatically turns parameters into form fields or MCP tool inputs.
How does Floom handle authentication and rate limiting?
Floom supports Bearer/API‑key authentication and per‑operation rate limits. Secrets are injected at runtime from environment variables or a config file.
Can I self‑host Floom?
Yes. Self‑hosting takes about 60 seconds: write an apps.yaml manifest and run the official Docker image (ghcr.io/floomhq/floom-monorepo). The full guide is in docs/SELF_HOST.md.
What are the two operation modes (proxied vs. hosted)?
In proxied mode Floom wraps an existing API by reading its OpenAPI spec. In hosted mode Floom runs your own container, using a runtime, build, and run directive in the manifest.
Does Floom expose MCP tools for agents?
Yes. Every published app automatically provides MCP tools. Additionally, four MCP admin tools (ingest_app, list_apps, search_apps, get_app) let an agent add and manage apps over MCP.
Frequently asked questions
What input formats does Floom support?
Floom accepts an OpenAPI specification (URL or local file). It reads each operation and automatically turns parameters into form fields or MCP tool inputs.
How does Floom handle authentication and rate limiting?
Floom supports Bearer/API‑key authentication and per‑operation rate limits. Secrets are injected at runtime from environment variables or a config file.
Can I self‑host Floom?
Yes. Self‑hosting takes about 60 seconds: write an `apps.yaml` manifest and run the official Docker image (`ghcr.io/floomhq/floom-monorepo`). The full guide is in `docs/SELF_HOST.md`.
What are the two operation modes (proxied vs. hosted)?
In **proxied** mode Floom wraps an existing API by reading its OpenAPI spec. In **hosted** mode Floom runs your own container, using a `runtime`, `build`, and `run` directive in the manifest.
Does Floom expose MCP tools for agents?
Yes. Every published app automatically provides MCP tools. Additionally, four MCP admin tools (`ingest_app`, `list_apps`, `search_apps`, `get_app`) let an agent add and manage apps over MCP.
Basic information
More Other MCP servers
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Awesome Mlops
visengerA curated list of references for MLOps
Comments