Dreamlit MCP Server (ai.dreamlit/mcp)

Dreamlit MCP enables AI clients to create, inspect, test, publish, unpublish, analyze, and style Dreamlit notification workflows. The server is used to build notification workflows from outcome-oriented prompts, review and publish them through Dreamlit, and answer bounded analytics questions about notification performance.

🛠️ Key Features

Create and manage Dreamlit notification workflows
Inspect, test, publish, and unpublish workflows
Analyze and style workflows
Tool availability: 11 tools

🚀 Use Cases

Generate notification workflows for Supabase and Postgres apps
Review and publish workflows through an AI client
Ask bounded analytics questions about notification performance

⚡ Developer Benefits

Production endpoint: https://mcp.dreamlit.ai/mcp
Transport: Streamable HTTP
Authentication: OAuth, using personal access

⚠️ Limitations

Readme excerpt does not define which workflow inputs/outputs or analytics methods are supported in detail.

Dreamlit MCP

Dreamlit MCP lets AI clients create, inspect, test, publish, unpublish, analyze, and style Dreamlit notification workflows.

Dreamlit is a database-driven notification workflow platform for Supabase and Postgres apps. Use this MCP server when you want an AI client to help build notification workflows from outcome-oriented prompts, review and publish them through Dreamlit, or answer bounded analytics questions about notification performance.

Server

Production MCP URL: https://mcp.dreamlit.ai/mcp
Transport: Streamable HTTP
Authentication: OAuth, with personal access token fallback for clients that do not support OAuth

This repository contains public setup docs and MCP registry metadata for Dreamlit's hosted remote MCP server. The production backend implementation is not open source.

Quick Start

Use your MCP client's remote server flow and enter:

text

https://mcp.dreamlit.ai/mcp

The client should open a Dreamlit authorization page. Choose the workspace you want the AI client to access and approve the requested scopes.

Codex CLI

codex mcp add dreamlit --url https://mcp.dreamlit.ai/mcp
codex mcp login dreamlit

To request every supported v1 scope explicitly:

codex mcp login dreamlit --scopes workflows:read,workflows:write,workflows:publish,analytics:read

MCP Inspector

npx @modelcontextprotocol/inspector

Then choose Streamable HTTP and use:

text

https://mcp.dreamlit.ai/mcp

Tools

Dreamlit exposes product-level workflow and analytics tools, not low-level graph editing or database APIs.

Tool	Scope	Purpose
`get_status`	`workflows:read`	Get Dreamlit guidance, workspace context, project setup, schema hints, workflow state, and app URLs.
`list_projects`	`workflows:read`	Find accessible Dreamlit projects in the approved workspace.
`list_workflows`	`workflows:read`	Find workflows in a project by name, description, trigger type, and pagination.
`list_brand_kits`	`workflows:read`	Find saved brand kit ids and style summaries with pagination before applying one to generated email drafts.
`get_workflow_and_preview_url`	`workflows:read`	Inspect a workflow draft and get the Dreamlit preview or builder URL before editing or publishing.
`get_analytics`	`analytics:read`	Query bounded notification analytics, recipient engagement, and workflow run data with filters and cursor pagination.
`create_or_update_workflow`	`workflows:write`	Create a new workflow draft or update an existing draft from a natural-language prompt.
`send_workflow_test`	`workflows:write`	Confirm and send a draft email or Slack test without publishing the workflow.
`prepare_publish`	`workflows:publish`	Validate a workflow before publishing and return confirmation fields.
`confirm_publish`	`workflows:publish`	Publish or schedule a workflow after explicit user confirmation.
`unpublish_workflow`	`workflows:publish`	Disable live triggers or schedules for a workflow.

Recommended Flow

Call get_status first to understand the workspace, project setup, and prompting guidance.
Use list_projects and list_workflows if the user names a project or workflow without IDs.
Use list_brand_kits when the user wants a specific saved brand kit applied to generated email drafts.
Use get_workflow_and_preview_url before editing an existing workflow.
Use get_analytics for bounded analytics questions, filtering first and paginating with returned cursors for larger result sets.
Use create_or_update_workflow to create or update a draft.
Open the returned preview or builder URL and send workflow tests for important email or Slack messages.
Publish only after explicit user confirmation, using prepare_publish followed by confirm_publish.

Drafts are not live after authoring. Publishing is always a separate explicit step.

Prompting Tips

Ask for the outcome, not a workflow graph. Good prompts include:

The event or schedule that should start the workflow.
The audience or recipient.
The message goal and tone.
The data needed for personalization.
Timing, timezone, and business rules.
Whether recipients should be able to unsubscribe.

Examples:

text

When a new organization row is inserted, send an internal Slack alert with the organization name, owner email, and plan.

text

Every Monday at 9 AM America/New_York, send admins a weekly usage digest summarizing active users, failed payments, and new signups.

text

Tomorrow at 10 AM, announce the launch to active users who opted into product updates. Include unsubscribe.

Access Model

OAuth access is scoped to the workspace selected during authorization. Personal access tokens are project scoped and can be created from Dreamlit project settings.

Available scopes:

workflows:read
workflows:write
workflows:publish
analytics:read

Use the least privilege that fits the client. Read-only workflow and brand-kit clients should request only workflows:read; analytics clients should request analytics:read.

Data Handling

Dreamlit MCP can access workflow metadata, saved brand kit summaries, connected project context, and bounded analytics results needed to perform the requested actions. It does not require clients to send database credentials through MCP.

Analytics access is structured and paginated. Use filters and cursors for larger result sets; CSV exports and bulk dumps are not exposed through MCP.

Do not paste secrets, raw credentials, or private tokens into prompts. Use Dreamlit's app settings for integrations and credentials.

Support

For support, contact support@dreamlit.ai.

projectId	string	optional	Optional project id. Include it to return project setup, schema hints, and authoring context.
workflowId	string	optional	Optional workflow id. Include it to return concise workflow state and preview URL.

prompt	string	required	Outcome-oriented workflow authoring request. Describe the event or schedule, audience, recipient, message goal, data needed, timing, business rules, and unsubscribe intent. Let Dreamlit choose email styling unless the user gives specific style direction. For broadcasts, request a future send time instead of an immediate send.
projectId	string	optional	Target project id for creating a new workflow draft.
workflowId	string	optional	Existing workflow id to continue editing. Use get_workflow_and_preview_url first when changing an existing workflow.
userCurrentTimeIso	string	optional	User's current time as an ISO timestamp with offset, useful for relative schedule requests.
userCurrentTimeZoneId	string	optional	IANA timezone id for the user, useful for repeating workflows and scheduled broadcasts.
userEmailStepComments	array	optional	Optional inline comments for revising email step content.

search	string	optional	Optional project name search string.
limit	integer	optional	Maximum number of projects to return.

projectId	string	optional	Project id to list workflows from. Required when access is ambiguous.
search	string	optional	Optional workflow name or description search string.
triggerFilters	array	optional	Optional trigger type filters. Use broadcast only for one-time audience emails.
limit	integer	optional	Maximum number of workflows to return for this page.
offset	integer	optional	Zero-based workflow offset for pagination. Use nextOffset from the previous response to fetch the next page.

projectId	string	optional	Project id to list brand styles from. Required when access is ambiguous.
limit	integer	optional	Maximum number of brand styles to return for this page.
offset	integer	optional	Zero-based brand style offset for pagination. Use nextOffset from the previous response to fetch the next page.

Dreamlit

Dreamlit MCP Server (ai.dreamlit/mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_status

create_or_update_workflow

list_projects

list_workflows

list_brand_styles

get_workflow_and_preview_url

get_analytics

send_workflow_test

prepare_publish

confirm_publish

unpublish_workflow

Dreamlit MCP

Server

Quick Start

Codex CLI

MCP Inspector

Tools

Recommended Flow

Prompting Tips

Access Model

Data Handling

Support

Install

Remote endpoint

Related servers

workflowId	string	required	Workflow id to publish.
isSandboxed	boolean	optional	Whether to publish in sandbox mode so notifications are held for inspection.
expectedEditableVersionId	any	optional	Editable version id returned by prepare_publish, used as a safety check.
expectedPublishedVersionId	any	optional	Published version id returned by prepare_publish, used as a safety check.
expectedUpdatedAtIso	any	optional	Workflow updatedAt timestamp returned by prepare_publish, used as a safety check.