Publish Markdown and HTML from your AI session as a live website. No account needed.
app.flowershow/flowershow MCP Server
This MCP server publishes Markdown and HTML generated in an AI session as a live website. It provides a way to publish content without creating an account. The server is identified by the slug app-flowershow-flowershow.
๐ ๏ธ Key Features
Publish Markdown and HTML from an AI session
Serve the content as a live website
No account required
๐ Use Cases
Turn AI session output (Markdown/HTML) into a live web page
Publish HTML/Markdown drafts for immediate viewing
โก Developer Benefits
Integrates with workflows that generate Markdown and HTML content
Avoids account setup by design
โ ๏ธ Limitations
Tool details are not provided (no tool count or specific interface described)
Publish files as a live website on Flowershow and get a shareable URL. Use when the user says "publish this", "put this online", "make this a website", "share this as a page" or "host this".
Accepts Markdown (.md, rendered as a styled page with navigation), HTML (.html, served as-is) and supporting files such as CSS, JS, JSON and images: one page or a small site, up to 50 files and 3 MB per call. Name the home page index.md or index.html.
Without an account this creates a new site that expires in 7 days and returns a claim link: always show the user the live URL and the claim link exactly as returned, so they can keep the site. To update that site later in the conversation, call publish again with its siteId and claimToken and only the files you changed or added: files you don't send are kept as they are. To remove pages or files, list their paths in delete (files can then be empty). Only when the user explicitly asks to start the site over, set replaceWholeSite to true: the files you send become the whole site and every other file is removed. If that would remove existing files, the call is refused and tells you how many and which; ask the user, then call again with confirmDeleteCount set to that number. For bigger sites, suggest the Flowershow CLI (fl).
Parameters6
files
array
required
Files to add or update. When updating a site, send only the files that changed; other files are kept. Can be empty when only deleting.
siteId
string
optional
Update this existing site instead of creating a new one
claimToken
string
optional
The claimToken returned when the anonymous site was created (needed with siteId when not signed in)
delete
array
optional
Paths of existing files to remove from the site (with siteId), e.g. ["old-page.md"]
replaceWholeSite
boolean
optional
Set true only when the user asks to start the site over: the files sent become the whole site and all other files are permanently removed. Never use it to update a few pages. Default false.
confirmDeleteCount
integer
optional
With replaceWholeSite: the number of existing files the replace will remove, as reported by the refused first call. Set it only after the user has confirmed.
Raw schema
{
"type": "object",
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Relative path, e.g. \"index.html\" or \"img/logo.png\""
},
"content": {
"description": "Text content (UTF-8)",
"type": "string"
},
"contentBase64": {
"description": "Binary content, base64-encoded (images etc.)",
"type": "string"
}
},
"required": [
"path"
]
},
"description": "Files to add or update. When updating a site, send only the files that changed; other files are kept. Can be empty when only deleting."
},
"siteId": {
"description": "Update this existing site instead of creating a new one",
"type": "string"
},
"claimToken": {
"description": "The claimToken returned when the anonymous site was created (needed with siteId when not signed in)",
"type": "string"
},
"delete": {
"description": "Paths of existing files to remove from the site (with siteId), e.g. [\"old-page.md\"]",
"maxItems": 1000,
"type": "array",
"items": {
"type": "string"
}
},
"replaceWholeSite": {
"description": "Set true only when the user asks to start the site over: the files sent become the whole site and all other files are permanently removed. Never use it to update a few pages. Default false.",
"type": "boolean"
},
"confirmDeleteCount": {
"description": "With replaceWholeSite: the number of existing files the replace will remove, as reported by the refused first call. Set it only after the user has confirmed.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"files"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}
Flowershow is a product of Datopian - dedicated to democratising the power of data & knowledge.
Publish
Just login in the website and you can publish in seconds by drag and drop, from Obsidian (plugin), from Github and more.
Command line (for AI)
The CLI is a single binary called fl.
bash
# Install (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/flowershow/flowershow/main/apps/cli/install.sh | sh
# Log in and publish a folder or file
fl login
fl ./my-notes
Windows: download fl_windows_amd64.zip from the latest release and put fl.exe on your PATH. Full details: CLI reference.
For Developers (contributing to Flowershow itself)
You do not need anything below to use Flowershow. To install and publish, see Install and publish above. This section is only for people developing the Flowershow platform from source.
Monorepo Structure
This is a Turborepo monorepo managed with pnpm workspaces.
code
apps/
flowershow/ # Next.js web application (flowershow.app)
cli/ # Go CLI (`fl`) โ publish markdown files from the terminal or AI agents
packages/
api-contract/ # @flowershow/api-contract โ Zod schemas, TS types, OpenAPI 3.1 spec
cloudflare-worker/ # Markdown processing Cloudflare worker
remark-wiki-link/ # @flowershow/remark-wiki-link โ remark plugin for wiki-style links
content/
flowershow-app/ # Marketing site content (Obsidian vault, not a workspace package)
# Clone (include the e2e test-site submodule)
git clone --recurse-submodules https://github.com/flowershow/flowershow.git
cd flowershow
# Install dependencies
pnpm install
# Copy env template (then edit apps/flowershow/.env with your secrets)cp apps/flowershow/.env.example apps/flowershow/.env
# Start everything: Postgres, MinIO, Inngest, Cloudflare Worker, Next.js app
pnpm dev
Visit http://cloud.localhost:3000 once it's running.
If you already cloned without --recurse-submodules, run
git submodule update --init to fetch the e2e test site.
Commands
bash
pnpm dev --stripe # Also start Stripe webhook forwarding
pnpm dev --github # Also start Smee (GitHub webhook proxy)
pnpm dev --search # Also start Typesense
pnpm dev:all # Start everything including all optional services
pnpm dev:local# Start dev servers only (no Docker infrastructure)
pnpm dev:local:all # Start dev servers only + all optional services
pnpm dev:down # Stop Docker containers (keep data)
pnpm dev:nuke # Stop containers + delete all data volumes
pnpm build # Build all packages
pnpm test# Run tests across all packages
pnpm lint # Lint all packages (ESLint for app, Biome for packages)
pnpm format # Check formatting (Biome)
pnpm format:write # Auto-fix formatting
A pre-commit hook automatically formats staged files via lint-staged before each commit.
Releasing packages
bash
pnpm changeset # Create a changeset describing your change
pnpm version-packages # Bump versions based on changesets
pnpm release # Build all packages and publish to npm
Documentation
Web app: apps/flowershow/README.md โ architecture, local dev setup, environment config, testing, troubleshooting
REST API contract: packages/api-contract/README.md โ Zod schemas, TypeScript types, and OpenAPI 3.1 spec for the Flowershow REST API. The contract is the single source of truth for the API surface; the Next.js API routes, CLI, and Obsidian plugin all consume it.
Interactive API docs: With the dev server running, visit http://cloud.flowershow.local:3000/api/docs for Swagger UI, or /api/docs/openapi.json for the raw spec. In production: flowershow.app/api/docs.
CLI: apps/cli/README.md โ Go CLI for publishing markdown files. Also the interface for AI agent integration โ see the Flowershow skill.