{ "data": { "a": { "slug": "clevertap", "name": "CleverTap", "vendor": "WizRocket Inc.", "vendorUrl": "https://clevertap.com", "kind": "http-api", "category": "lifecycle-marketing", "summary": "CleverTap is a hosted customer engagement platform that stores user profiles and events and sends campaigns by push, email, SMS, WhatsApp and in-app messages. Agents reach it through a REST API authenticated with an account ID and passcode.", "url": "https://www.anchorterminal.com/tools/clevertap", "markdownUrl": "https://www.anchorterminal.com/tools/clevertap.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/clevertap.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/clevertap.json", "dns": "clevertap.grade.anchorterminal.com", "repo": "https://github.com/CleverTap/clevertap-node", "license": "Proprietary service under CleverTap's Terms of Service. The Node.js API library on GitHub is MIT", "transports": [ "http" ], "packages": [ { "registry": "npm", "name": "clevertap" } ], "auth": "api-key", "authNotes": "Access needs a CleverTap account, which the Core plan's 30-day trial opens through a browser signup. Every call sends `X-CleverTap-Account-Id` and `X-CleverTap-Passcode` headers. An admin, or a user with write access to User Settings, creates up to 100 named account passcodes under Settings, Passcodes, each with an optional expiry, and can delete them. An admin can instead grant per-user passcodes, valid for 1 to 365 days or up to 10 years, and reset or revoke them. No scopes, read-only passcodes or OAuth were found for the customer API. Partners that connect customer accounts through `/v1/connect` are allowlisted by email request. SCIM provisioning has its own endpoints.", "pricing": "paid", "pricingNotes": "Core starts at 85 dollars a month for up to 5,000 monthly active users, before tax and add-ons, with a 30-day free trial. Billing details are needed before the last seven days of the trial, per the account docs. Prices for the larger tiers (20,000 to 100,000 users) are chosen in a selector that our reader did not see. Pro and Ultimate are sold through a demo. The plan table lists API access (import and export) as a plan item, and no per-call price was found. Each user is allowed 10,000 data points a month, with overage charges (checked 2026-10-09).", "priceSummary": "$85 / mo", "where": "local", "x402": { "level": "no", "evidence": "No x402, MPP or L402 in the developer docs index, the API pages read, the pricing page or the terms (checked 2026-10-09).", "endpoints": [] }, "toolCount": null, "popularity": { "githubStars": null, "npmWeekly": 2985, "pypiWeekly": null, "asOf": "2026-10-09" }, "docsUrl": "https://developer.clevertap.com/docs/api-overview", "llmsTxt": "https://developer.clevertap.com/llms.txt", "capabilities": [ "marketing.profiles", "marketing.events", "marketing.campaigns", "marketing.segments", "notify.push" ], "tags": [ "official", "hosted", "api-key", "llms-txt", "closed-source", "eu-region", "soc2", "node" ], "lastRelease": "2026-10-01", "graded": true, "anchor": { "graded": true, "score": 50.4, "grade": "D", "agentReady": false, "rank": 1066, "ranked": true, "rankOf": 1510, "categoryRank": 11, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 53, "maintenance": 73, "payments": 25, "reliability": 37, "schema": 57, "security": 56, "transparency": 66 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-11-04" }, "negative": 0, "verdict": "CleverTap's REST API uploads and reads profiles and events, creates and stops campaigns and reports results, with Markdown docs, numeric concurrency limits and a 30-day Core trial. No OpenAPI file or public status page was found, passcodes carry no scopes, and the docs say campaigns created through the API are not restricted by role-based access control.", "bestFor": "A team already on CleverTap that wants an agent to load profiles and events, read them back, create or stop API campaigns and pull campaign reports.", "strengths": [ "Both docs hosts publish llms.txt and a Markdown twin of every page, with request examples in up to six languages", "A concurrency limit is published for 23 API groups, 15 parallel requests on uploads and 3 on the others", "Up to 100 named account passcodes with optional expiry, plus per-user passcodes an admin can reset or revoke", "Create Campaign accepts `estimate_only` to return reach without creating anything and `draft` to save without sending", "Audit logs list API key creation and revocation and API access, with CSV download and a daily export to cloud storage" ], "weaknesses": [ "No OpenAPI file was found. The contract is prose tables plus a Postman collection published as a zip on GitHub", "No public status page or SLA was found on the site, the docs or the terms, which leave service levels to each order", "Passcodes carry no scopes or read-only mode, and the docs say campaigns created through the API are not restricted by role-based access control", "Get User Profiles returns some throttling errors with HTTP 200 and a `fail` status in the body", "The Terms of Service (30 April 2021) bar customers from publicly disseminating information on the performance of the Services, which matters before any probe is run" ], "agentNotes": [ "Call the host for the account's region, such as `in1.api.clevertap.com` or `us1.api.clevertap.com`. `api.clevertap.com` is the Europe region", "Send `X-CleverTap-Account-Id` and `X-CleverTap-Passcode` headers on every call, and ask for a named passcode with an expiry date", "Check `status` in the body as well as the HTTP code. Get User Profiles can answer 200 with `\"status\":\"fail\"` when throttled", "Add `dryRun=1` to an upload URL to validate up to 1,000 records without storing them", "Set `estimate_only` or `draft` to true on Create Campaign before a real send. API campaigns bypass dashboard role restrictions" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "D", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 50.4 } ], "editorialScores": { "ergonomics": 53, "maintenance": 73, "payments": 25, "reliability": 37, "schema": 57, "security": 56, "transparency": 50 }, "provenanceScore": 81, "checked": { "categories": { "ergonomics": "2026-11-04", "maintenance": "2026-11-04", "payments": "2026-11-04", "reliability": "2026-11-04", "schema": "2026-11-04", "security": "2026-11-04", "transparency": "2026-11-04" }, "last": "2026-11-04", "lastMoved": "2026-11-04", "oldest": "2026-11-04", "stale": false, "staleAfterDays": 90 } }, "connect": { "install": "npm install clevertap", "http": "curl -X POST -d '{\"d\":[{\"identity\":\"USER_ID\",\"type\":\"profile\",\"profileData\":{\"Name\": \"George Montana\", \"Customer Type\": \"Silver\"}}]}' \"https://in1.api.clevertap.com/1/upload\" \\\n-H \"X-CleverTap-Account-Id: ACCOUNT_ID\" \\\n-H \"X-CleverTap-Passcode: PASSCODE\" \\\n-H \"Content-Type: application/json; charset=utf-8\"" }, "letme": { "capability": "https://letme.dev/marketing.profiles", "tool": "https://letme.dev/clevertap" }, "area": "communication", "unitPrices": [ { "item": "Core, up to 5,000 monthly active users", "unit": "month", "usd": 85, "note": "before tax and add-ons, after a 30-day trial" } ], "provenance": { "legalEntity": "WizRocket Inc.", "domain": "clevertap.com", "domainRegistered": "2015-08-19", "endpointOnVendorDomain": true, "terms": "https://clevertap.com/terms-service/", "privacy": "https://clevertap.com/privacy-policy/", "statusPage": "", "changelog": "https://docs.clevertap.com/docs/whats-new", "securityTxt": "none", "checked": "2026-11-04", "notes": [ "The Terms of Service (last updated 30 April 2021) govern the software-as-a-service products of WizRocket Inc. and its affiliates and choose California law. The site footer gives CleverTap Private Limited as the legal name.", "The privacy policy (last updated 9 April 2026) names WizRocket Inc., a Delaware corporation, CleverTap Private Limited (India) and CleverTap Pte. Ltd. (Singapore), and covers CleverTap as processor of customers' end-user data.", "The API answers on api.clevertap.com and regional subdomains of it, all on the vendor's domain.", "https://clevertap.com/.well-known/security.txt returns 404 (re-read 4 November). No disclosure policy or bug bounty was found on the pages read.", "No status page is linked from the home page, the pricing, security, terms or privacy pages or either docs index. No status address was guessed.", "Product release notes are grouped by month with no day. SDK changelogs are monthly pages that link dated GitHub releases." ], "score": 81 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/clevertap.json", "live": { "slug": "clevertap", "versions": [ { "registry": "github", "name": "CleverTap/clevertap-node", "version": "v1.3.1", "released": "2026-07-07", "seenAt": "2026-11-06T23:15:02.824352522Z" }, { "registry": "npm", "name": "clevertap", "version": "1.3.1", "seenAt": "2026-11-06T23:15:02.609154774Z" } ], "githubStars": 8, "npmWeekly": 10088, "securityTxt": { "url": "https://clevertap.com/.well-known/security.txt", "state": "none", "checkedAt": "2026-11-07T16:00:22.421579743Z" }, "llmsTxt": { "url": "https://developer.clevertap.com/llms.txt", "ok": true, "status": 200, "checkedAt": "2026-11-07T15:31:50.896256339Z" }, "domain": { "domain": "clevertap.com", "registered": "2015-08-19", "source": "https://rdap.verisign.com/com/v1/domain/clevertap.com", "checkedAt": "2026-11-01T14:10:49.050572856Z" }, "pages": [ { "url": "https://docs.clevertap.com/docs/whats-new", "kind": "changelog", "status": 200, "checkedAt": "2026-11-07T14:05:31.280592866Z", "changedAt": "2026-11-06T13:28:00.574826487Z", "fingerprint": "2dd6b2658580" }, { "url": "https://clevertap.com/privacy-policy/", "kind": "privacy", "status": 304, "checkedAt": "2026-11-07T14:01:05.114901781Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "df19d42437f7" }, { "url": "https://clevertap.com/terms-service/", "kind": "terms", "status": 304, "checkedAt": "2026-11-07T14:01:07.156662057Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "e8f066ae0f2d" } ], "github": { "repo": "clevertap/clevertap-node", "checkedAt": "2026-11-02T08:39:02.273868525Z", "stars": 8, "archived": false, "issuesEnabled": true, "pushedAt": "2026-07-07T06:20:22Z", "openIssues": 2, "openPRs": 2, "issuesOpened90d": 0, "issuesClosed90d": 0, "prsMerged90d": 0, "replies": { "sampled": 9, "unanswered": 2, "medianDays": 235.1 } }, "updatedAt": "2026-11-07T16:00:22.421579743Z" } }, "answer": "Dreamlit scores 57 (C) on agent readiness against CleverTap's 50.4 (D), and leads in 5 of 7 scored categories. CleverTap leads on payments \u0026 pricing and transparency \u0026 trust.", "b": { "slug": "dreamlit", "name": "Dreamlit", "vendor": "Notika AI", "vendorUrl": "https://dreamlit.ai", "kind": "mcp", "category": "lifecycle-marketing", "summary": "Dreamlit is a lifecycle email service that runs notification workflows from a connected Supabase or Postgres database. AI agents build, test and publish those workflows and read their analytics through a hosted MCP server.", "url": "https://www.anchorterminal.com/tools/dreamlit", "markdownUrl": "https://www.anchorterminal.com/tools/dreamlit.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/dreamlit.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/dreamlit.json", "dns": "dreamlit.grade.anchorterminal.com", "repo": "https://github.com/dreamlit-ai/dreamlit-mcp", "transports": [ "streamable-http" ], "remoteUrl": "https://mcp.dreamlit.ai/mcp", "packages": [], "auth": "oauth", "authNotes": "OAuth from the MCP client to one Dreamlit workspace, with scopes `workflows:read`, `workflows:write`, `workflows:publish` and `analytics:read`. Clients that can't do OAuth use a project-scoped personal access token (`dlpt_`) with chosen scopes, shown once, sent as a Bearer header. Accounts and database connections are set up in the web app first.", "pricing": "paid", "pricingNotes": "Pro $20 a month ($16 billed yearly) with 30,000 emails and 250 agent credits; Scale $99 ($79 yearly) with 100,000 emails; Enterprise custom. No free plan for new accounts. MCP calls carry no extra charge. Autopilot, a done-for-you service, is priced separately.", "priceSummary": "$20 / mo", "where": "hosted", "x402": { "level": "no", "evidence": "No x402, MPP or L402 in llms.txt, pricing.md or the MCP docs (checked 2026-11-06).", "endpoints": [] }, "toolCount": 16, "popularity": { "githubStars": null, "npmWeekly": null, "pypiWeekly": null, "asOf": "2026-11-06" }, "docsUrl": "https://dreamlit.ai/docs/resources/mcp-server", "llmsTxt": "https://dreamlit.ai/llms.txt", "registryName": "ai.dreamlit/mcp", "capabilities": [ "marketing.journeys", "marketing.campaigns", "marketing.events", "email.send", "email.templates", "email.analytics" ], "tags": [ "hosted", "closed-source", "mcp", "remote-mcp", "mcp-registry", "oauth", "llms-txt", "approvals", "status-page", "supabase", "postgres" ], "lastRelease": "2026-10-12", "graded": true, "anchor": { "graded": true, "score": 57, "grade": "C", "agentReady": false, "rank": 813, "ranked": true, "rankOf": 1510, "categoryRank": 9, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 67, "maintenance": 80, "payments": 10, "reliability": 51, "schema": 59, "security": 74, "transparency": 59 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-11-06" }, "negative": 0, "verdict": "Scoped OAuth and a two-step prepare-then-confirm publish let an agent draft and test lifecycle workflows without sending anything live by mistake. There is no REST API or published rate limit, tool schemas aren't public outside a session, there's no free plan, and its security page and privacy policy disagree on retention.", "bestFor": "Small product teams on Supabase or Postgres who want their coding agent to build lifecycle and transactional email workflows.", "strengths": [ "Separate OAuth scopes for reading, drafting, publishing and analytics, and project-scoped tokens", "Nothing goes live without `prepare_publish` followed by an approved `confirm_publish`", "`send_workflow_test` sends a draft to the user or a chosen address without publishing", "Better Stack status page with 90 days of history for the web app and workflow engine", "Dated changelog with eight entries between 10 August and 12 October 2026" ], "weaknesses": [ "No REST API, SDK or OpenAPI; the MCP server is the only programmatic route", "No rate limits, 429 guidance or idempotency documented for MCP calls", "No free plan for new accounts; Pro starts at $20 a month", "The status page has no component for the MCP server", "The security page says no copy of data is kept, while the privacy policy keeps workflow history and delivery events for up to a year" ], "agentNotes": [ "Call `get_status` first to see the workspace, project setup state and prompting guidance", "Use `send_workflow_test` to the user before `prepare_publish`, and call `confirm_publish` only after the user approves the returned payload", "Request `workflows:read` and `analytics:read` only when the task is reporting, so the grant can't publish", "Expect a browser hand-off link when setup or an unsupported edit needs the web app, and pass it to the user" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "C", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 57 } ], "editorialScores": { "ergonomics": 67, "maintenance": 80, "payments": 10, "reliability": 51, "schema": 59, "security": 74, "transparency": 42 }, "provenanceScore": 75, "checked": { "categories": { "ergonomics": "2026-11-06", "maintenance": "2026-11-06", "payments": "2026-11-06", "reliability": "2026-11-06", "schema": "2026-11-06", "security": "2026-11-06", "transparency": "2026-11-06" }, "last": "2026-11-06", "oldest": "2026-11-06", "stale": false, "staleAfterDays": 90 } }, "connect": { "claudeCode": "claude mcp add --transport http dreamlit https://mcp.dreamlit.ai/mcp", "config": { "mcpServers": { "dreamlit": { "url": "https://mcp.dreamlit.ai/mcp" } } } }, "letme": { "capability": "https://letme.dev/marketing.journeys", "tool": "https://letme.dev/dreamlit" }, "area": "communication", "unitPrices": [ { "item": "Pro", "unit": "month", "usd": 20, "note": "30,000 emails a month, 250 agent credits; $16 billed yearly" }, { "item": "Scale", "unit": "month", "usd": 99, "note": "100,000 emails a month, 500 agent credits; $79 billed yearly" } ], "provenance": { "legalEntity": "Notika AI (d/b/a Dreamlit AI)", "domain": "dreamlit.ai", "domainRegistered": "", "endpointOnVendorDomain": true, "terms": "https://dreamlit.ai/terms-of-service", "privacy": "https://dreamlit.ai/privacy-policy", "statusPage": "https://status.dreamlit.ai", "changelog": "https://dreamlit.ai/changelog", "securityTxt": "none", "checked": "2026-11-06", "notes": [ "The terms and privacy policy, both last updated 29 January 2026, name Notika AI (d/b/a Dreamlit AI).", "dreamlit.ai/robots.txt allows all paths with Content-Signal ai-input=yes. The terms contain no clause on automated access to the website that we found.", "RDAP for dreamlit.ai returned a transfer event (8 June 2025) but no registration date.", "/.well-known/security.txt returns 404. The security page claims penetration testing and a bug bounty programme without a link; the MCP repository's SECURITY.md routes reports to the support address.", "The privacy policy says subprocessors are listed and SCCs are offered in a DPA at dreamlit.ai/dpa." ], "score": 75 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/dreamlit.json", "live": { "slug": "dreamlit", "probe": { "target": "https://mcp.dreamlit.ai/mcp", "method": "mcp-initialize", "lastAt": "2026-11-07T19:22:04.196961592Z", "lastOk": true, "lastStatus": 200, "lastMs": 187, "lastNote": "initialize answered", "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 156, "p95ms24h": 303, "samples24h": 210, "samples30d": 210, "days": [ { "date": "2026-11-06", "probes": 13, "ok": 13 }, { "date": "2026-11-07", "probes": 197, "ok": 197 } ] }, "vendorStatus": { "page": "https://status.dreamlit.ai", "indicator": "unknown", "summary": "no machine-readable status found", "checkedAt": "2026-11-07T04:47:40.393037973Z" }, "versions": [ { "registry": "mcp-registry", "name": "ai.dreamlit/mcp", "version": "0.1.0", "seenAt": "2026-11-07T18:16:28.95801333Z" } ], "githubStars": 0, "securityTxt": { "url": "https://dreamlit.ai/.well-known/security.txt", "state": "none", "checkedAt": "2026-11-07T15:59:27.690762051Z" }, "llmsTxt": { "url": "https://dreamlit.ai/llms.txt", "ok": true, "status": 200, "checkedAt": "2026-11-07T15:32:19.99369807Z" }, "pages": [ { "url": "https://dreamlit.ai/changelog", "kind": "changelog", "status": 200, "checkedAt": "2026-11-07T14:08:59.883908631Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "d5efd0517602" }, { "url": "https://dreamlit.ai/privacy-policy", "kind": "privacy", "status": 200, "checkedAt": "2026-11-07T14:09:02.82685007Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "5cea1328f21d" }, { "url": "https://dreamlit.ai/terms-of-service", "kind": "terms", "status": 200, "checkedAt": "2026-11-07T14:09:04.008676629Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "9fbc316c2506" } ], "mcpTools": { "url": "https://mcp.dreamlit.ai/mcp", "checkedAt": "2026-11-07T01:43:51.385315264Z", "status": "ok", "protocol": "2025-11-25", "tools": [ { "name": "get_status", "title": "Get status", "description": "Read-only. Use first when the agent needs Dreamlit product guidance, prompting guidance, approved workspace context, project setup, schema hints, workflow state, or relevant app URLs. Returns a compact context pack with concepts, recommended tool flow, actor/workspace/project data, optional authoring context, optional workflow context, and appUrls. Workflow summaries include liveStatus, and broadcasts include an authoritative broadcast.state. Database tables that Dreamlit can see but not read rows from (row level security with no policy for Dreamlit) carry a warning and fixSql; run fixSql, or ask the user to run it, in the Supabase SQL editor. If Dreamlit couldn't read a connection's tables, that connection has tablesError instead of an empty list meaning no tables. Do not use this to create, update, publish, or unpublish workflows.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "projectId": { "description": "Optional project id. Include it to return project setup, schema hints, and authoring context.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Optional workflow id. Include it to return concise workflow state and preview URL.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Get status" } }, { "name": "create_or_update_workflow", "title": "Create or update workflow", "description": "Creates a new Dreamlit workflow draft or updates an existing draft from an outcome-oriented natural-language prompt. Use after get_status; use get_workflow_and_preview_url first when editing an existing workflow, then describe the steps to change by what they do, not by step id. Each call continues the workflow's current chat; pass startNewChat to start fresh. Broadcasts that are scheduled, sent, or cancelled can't be edited; duplicate them in the Dreamlit web app instead. Existing Supabase Auth workflows can be edited except for the immutable trigger step; creating Supabase Auth workflows must happen through Supabase Auth email setup in the Dreamlit web app. Side effect: may create or modify a draft, but does not publish or install live triggers. Returns the workflow/draft result, action-required or handoff details when more input is needed, and relevant app URLs. Do not use for publishing, direct database changes, or low-level graph edits.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "name": { "description": "Name for a new workflow draft. Use when the user names the workflow; otherwise Dreamlit picks one. Only valid when creating; use rename_workflow to rename an existing workflow.", "type": "string" }, "projectId": { "description": "Target project id for creating a new workflow draft.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "prompt": { "description": "Outcome-oriented workflow authoring request. Describe the event or schedule, audience, recipient, message goal, data needed, timing, business rules, and unsubscribe intent. When editing, refer to existing steps by what they do (for example, the query that finds returning customers, or the email with subject \"Welcome back\"), never by step id. Let Dreamlit choose email styling unless the user gives specific style direction. For broadcasts, request a future send time instead of an immediate send.", "minLength": 1, "type": "string" }, "startNewChat": { "description": "Start a fresh Dreamlit chat for this request instead of continuing the workflow's current chat. The new chat still sees the current draft but not earlier turns. Use when switching to an unrelated change, after long turns with pasted SQL or HTML, or when Dreamlit keeps misreading the request. Ignored when creating a workflow.", "type": "boolean" }, "userCurrentTimeIso": { "description": "User's current time as an ISO timestamp with offset, useful for relative schedule requests.", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "userCurrentTimeZoneId": { "description": "IANA timezone id for the user, useful for repeating workflows and scheduled broadcasts.", "minLength": 1, "type": "string" }, "userEmailStepComments": { "description": "Optional inline comments for revising email step content.", "items": { "properties": { "comment": { "description": "User's requested change.", "minLength": 1, "type": "string" }, "onCodeLineText": { "description": "Nearby email editor text for anchoring the comment.", "minLength": 1, "type": "string" }, "userHighlightedText": { "description": "Specific text selected by the user.", "minLength": 1, "type": "string" }, "workflowStepId": { "description": "Workflow step id that the user commented on.", "minLength": 1, "type": "string" } }, "required": [ "workflowStepId", "comment", "onCodeLineText", "userHighlightedText" ], "type": "object" }, "type": "array" }, "workflowId": { "description": "Existing workflow id to continue editing. Use get_workflow_and_preview_url first when changing an existing workflow.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "prompt" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Create or update workflow" } }, { "name": "edit_workflow_steps", "title": "Edit workflow steps", "description": "Applies up to 5 exact edits to existing steps in a workflow draft, instantly and without AI: email subject, preview text, HTML, sender, reply-to, and recipient; Slack message; query SQL; wait rule; and step description. Use when you know the exact new value; call get_workflow_and_preview_url first for step ids and current values, with includeEmailHtml to edit HTML. Edits are checked against the draft as it will be once they are all saved: templates and waits may only use fields their step gets, and query edits are rejected if later steps still use fields the new query no longer returns. Each edit applies on its own, except that a SQL edit and the edits below it apply together or not at all. The edits show in the workflow's Dreamlit chat. Side effect: changes the draft only; does not publish. Returns each edit's status with an error code and message for failed edits, and app URLs. Do not use to add, remove, or move steps, edit triggers, or make changes that need writing or judgment; use create_or_update_workflow for those.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "edits": { "description": "Up to 5 edits, each to a different existing step. Fields must match the step type: email* fields for email steps, slackTemplate for Slack, queryText for queries, wait for waits.", "items": { "additionalProperties": false, "properties": { "description": { "description": "Step description for email, query, or Slack steps. Empty string clears it.", "type": "string" }, "emailFromAddress": { "description": "Sender address on one of the project's sending domains.", "minLength": 1, "type": "string" }, "emailFromName": { "description": "Sender name. Empty string clears it.", "type": "string" }, "emailHtml": { "description": "Full replacement email HTML body. Liquid allowed. Read the current body with get_workflow_and_preview_url includeEmailHtml first. Emails that allow unsubscribe must keep a link to {{ dreamlit_unsubscribe_url }}.", "minLength": 1, "type": "string" }, "emailPreviewText": { "description": "Email preview text. Liquid allowed. Empty string clears it.", "type": "string" }, "emailReplyTo": { "description": "Reply-to address. Empty string clears it.", "type": "string" }, "emailSubject": { "description": "Email subject. Liquid allowed.", "minLength": 1, "type": "string" }, "emailTo": { "description": "Recipient address or Liquid, such as {{ email }}.", "minLength": 1, "type": "string" }, "queryText": { "description": "Full replacement SQL for a query step. Must stay read-only and keep returning the fields later steps use.", "minLength": 1, "type": "string" }, "slackTemplate": { "description": "Full replacement Slack message. Liquid allowed.", "minLength": 1, "type": "string" }, "stepId": { "description": "Existing step id from get_workflow_and_preview_url.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "wait": { "description": "Replaces the whole wait rule: a fixed duration, or until the date and time in a row field.", "oneOf": [ { "properties": { "amount": { "description": "How long to wait, up to 365 days in total.", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "duration", "type": "string" }, "unit": { "enum": [ "minutes", "hours", "days" ], "type": "string" } }, "required": [ "kind", "amount", "unit" ], "type": "object" }, { "properties": { "field": { "description": "Field from the step's input rows that holds a date and time with an offset, such as renewal_reminder_at. The wait ends at that time.", "minLength": 1, "type": "string" }, "kind": { "const": "until_row_field", "type": "string" } }, "required": [ "kind", "field" ], "type": "object" } ] } }, "required": [ "stepId" ], "type": "object" }, "maxItems": 5, "minItems": 1, "type": "array" }, "workflowId": { "description": "Workflow whose draft to edit.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "edits" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Edit workflow steps" } }, { "name": "rename_workflow", "title": "Rename workflow", "description": "Use when the user asks to rename an existing Dreamlit workflow. Side effect: changes only the workflow name; the draft, published version, and live triggers are unchanged. Returns the updated name and app URLs. Do not use to edit workflow content or to name a new workflow; pass name to create_or_update_workflow instead.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "name": { "description": "New workflow name. Leading and trailing spaces are removed; it can't be blank.", "type": "string" }, "workflowId": { "description": "Workflow id to rename.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "name" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false, "title": "Rename workflow" } }, { "name": "move_workflow_to_folder", "title": "Move workflow to folder", "description": "Use when the user asks to put a workflow or broadcast in a folder, move it to another folder, or take it out of a folder. Folders are per list: the Published and Drafts lists on the Workflows page and the Sent and Drafts lists on the Broadcasts page each have their own folders, and this moves the workflow within the list it shows in now. Folders are flat; a \"/\" is just part of the name. A draft's folder does not carry over when it is published. Side effect: may create the folder; never deletes folders and does not change the draft, published version, or live triggers. Returns the folder, the list, and app URLs. Do not use to rename or delete folders.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "folder": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Folder name, up to 64 characters. Matching ignores case and leading or trailing spaces; Dreamlit creates the folder if it doesn't exist yet. Pass null to take the workflow out of its folder." }, "workflowId": { "description": "Workflow id to move.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "folder" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false, "title": "Move workflow to folder" } }, { "name": "list_projects", "title": "List projects", "description": "Read-only. Use when the target project is unknown or the user names a project instead of providing an id. Returns accessible Dreamlit projects in the approved workspace with project and workflow-list URLs. Do not use to inspect workflow structure or author changes.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "default": 25, "description": "Maximum number of projects to return.", "maximum": 100, "minimum": 1, "type": "integer" }, "search": { "description": "Optional project name search string.", "maxLength": 200, "type": "string" } }, "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "List projects" } }, { "name": "list_workflows", "title": "List workflows", "description": "Read-only. Use to find workflows in a project by name, description, or trigger type before inspection or editing. Trigger filters include database, auth email, repeating, broadcast, and no-trigger workflows. Returns paginated workflow summaries, published/sandbox state, liveStatus, trigger type, folder (the folder name in the list the workflow shows in, or null), workflow URLs, totalCount, hasMore, and nextOffset. Broadcasts also include a broadcast object with state (draft, scheduled, sending, sent, cancelled, or failed), scheduledFor, and cancelledAt or completedAt; for broadcasts, broadcast.state and liveStatus are authoritative over published, because a cancelled broadcast stays published but will not send. Do not use as the final source of truth before editing; call get_workflow_and_preview_url for full structure.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "default": 80, "description": "Maximum number of workflows to return for this page.", "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Zero-based workflow offset for pagination. Use nextOffset from the previous response to fetch the next page.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "projectId": { "description": "Project id to list workflows from. Required when access is ambiguous.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "search": { "description": "Optional workflow name or description search string.", "maxLength": 200, "type": "string" }, "triggerFilters": { "description": "Optional trigger type filters. Use broadcast only for one-time audience emails.", "items": { "enum": [ "auth_email", "database", "broadcast", "repeating", "none" ], "type": "string" }, "type": "array" } }, "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "List workflows" } }, { "name": "list_brand_styles", "title": "List brand styles", "description": "Read-only. Use when the user wants to inspect saved project brand styles for generated email drafts. Returns paginated project brand style summaries, ids, default status, style metadata, and app URLs. Do not use to create, update, delete, or expose raw style provenance.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "default": 50, "description": "Maximum number of brand styles to return for this page.", "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Zero-based brand style offset for pagination. Use nextOffset from the previous response to fetch the next page.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "projectId": { "description": "Project id to list brand styles from. Required when access is ambiguous.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "List brand styles" } }, { "name": "get_workflow_and_preview_url", "title": "Get workflow and preview URL", "description": "Read-only. Use before editing, verifying, or preparing publish for an existing workflow. Returns normalized draft and published workflow structure, liveStatus, the Dreamlit preview/builder URL, and status URLs. Broadcasts also include a broadcast object with state (draft, scheduled, sending, sent, cancelled, or failed), the run's scheduledFor, and cancelledAt or completedAt; this, not published or the trigger's sendAt, says whether the broadcast will send. Email HTML bodies are left out unless includeEmailHtml is true. Pass step ids only to edit_workflow_steps; when asking create_or_update_workflow for changes, describe steps by what they do. Do not use to create, update, publish, or unpublish workflows.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "includeEmailHtml": { "description": "Also return each email step's full HTML body as emailTemplate.html. Off by default because bodies are large; turn on before editing email HTML with edit_workflow_steps.", "type": "boolean" }, "workflowId": { "description": "Workflow id to inspect before editing, verifying, or publishing.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Get workflow and preview URL" } }, { "name": "get_analytics", "title": "Get analytics", "description": "Read-only. Use get_analytics to query raw notification analytics: email and Slack sends and deliveries, email opens, clicks and bounces, overview metrics, per-recipient rows and workflow run rows, with filters, sorting, and cursor pagination. Returns bounded structured analytics data, effective query metadata, pagination details when rows are included, and relevant app URLs. Use get_lifecycle_report or get_recommendations for Dreamlit's prepared analysis. Does not provide Dreamlit's lifecycle judgments or prioritized recommendations. Do not use for CSV exports, bulk dumps, workflow edits, publishing, or low-level database access.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "channel": { "description": "Notification channel for overview and notification analytics. Defaults to email. Recipient analytics are email-only.", "enum": [ "email", "slack" ], "type": "string" }, "cursor": { "description": "Opaque pagination cursor from a previous get_analytics response.", "maxLength": 2048, "minLength": 1, "type": "string" }, "filters": { "description": "Optional analytics filters. Unsupported combinations return a clear error.", "properties": { "engagement": { "description": "Email engagement filter.", "enum": [ "undelivered", "bounced", "complained", "clicked", "opened" ], "type": "string" }, "notificationStatuses": { "description": "Email notification lifecycle statuses to include.", "items": { "enum": [ "sent", "pending", "releasable", "failed", "canceled", "suppressed", "opted_out" ], "type": "string" }, "maxItems": 7, "type": "array" }, "recipient": { "description": "Email recipient search string.", "maxLength": 320, "type": "string" }, "runStatuses": { "description": "Workflow run statuses to include. Only applies to workflow_runs.", "items": { "enum": [ "RUNNING", "PAUSED", "COMPLETED", "FAILED", "SKIPPED", "CANCELLED" ], "type": "string" }, "maxItems": 6, "type": "array" }, "slackWebhookIds": { "description": "Slack webhook ids to include for Slack notification analytics.", "items": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "maxItems": 100, "type": "array" }, "startedAt": { "description": "Workflow run started timestamp range. Only applies to workflow_runs.", "properties": { "from": { "description": "Inclusive ISO timestamp lower bound.", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "to": { "description": "Inclusive ISO timestamp upper bound.", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" } }, "type": "object" }, "topicIds": { "description": "Email unsubscribe topic ids to include.", "items": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "maxItems": 100, "type": "array" }, "workflowIds": { "description": "Workflow ids to include.", "items": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "maxItems": 100, "type": "array" }, "workflowRunId": { "description": "Workflow run id to include for notification analytics.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowStepRunId": { "description": "Workflow step run id to include for notification analytics.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "type": "object" }, "include": { "description": "Optional response sections to include. Defaults depend on the requested view.", "items": { "enum": [ "summary", "series", "rows", "recentEvents", "segments" ], "type": "string" }, "maxItems": 5, "type": "array" }, "limit": { "description": "Maximum rows to return. Defaults to 25 and is capped at 100.", "maximum": 100, "minimum": 1, "type": "integer" }, "projectId": { "description": "Project id to query analytics from. Required when access is ambiguous.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "range": { "description": "Optional explicit timestamp range. Overrides window and is applied to the view's primary timestamp.", "properties": { "from": { "description": "Inclusive ISO timestamp lower bound.", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "to": { "description": "Inclusive ISO timestamp upper bound.", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" } }, "type": "object" }, "sort": { "description": "Optional row sort. Overview ignores sorting.", "properties": { "dir": { "description": "Sort direction. Defaults to desc.", "enum": [ "asc", "desc" ], "type": "string" }, "field": { "description": "Sort field. Valid fields depend on the requested view.", "enum": [ "timestamp", "sentTo", "subject", "workflow", "engagement", "recipient", "lastSentAt", "sent", "opened", "clicked", "bounced", "complained" ], "type": "string" } }, "required": [ "field" ], "type": "object" }, "timeZone": { "description": "IANA timezone for daily series bucketing. Defaults to UTC.", "maxLength": 64, "minLength": 1, "type": "string" }, "view": { "description": "Analytics surface to query: overview cards, notification rows, recipient rows, or workflow run rows.", "enum": [ "overview", "notifications", "recipients", "workflow_runs" ], "type": "string" }, "window": { "description": "Relative analytics window. Defaults to 30d. Ignored when range is provided.", "enum": [ "1h", "24h", "7d", "14d", "30d", "90d", "all" ], "type": "string" } }, "required": [ "view" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Get analytics" } }, { "name": "get_lifecycle_report", "title": "Get lifecycle report", "description": "Side effect: creates a preparation request when no report is ready or refresh is true and the latest report became ready more than 24 hours ago; repeat calls reuse an open request. Pass refresh: true only when the user asks for a new report; when checking on a pending report, call without refresh. Use for Dreamlit's prepared lifecycle analysis: key metrics worth tracking, the signup-to-paid funnel and where users drop off, deliverability health, and which stages (welcome, onboarding, engagement, retention, winback) have no emails yet. Available on Pro and Scale plans only. Reports are prepared by Dreamlit's agents and reviewed by our team. Returns a ready report or a processing state while Dreamlit prepares it; check back later. The requester is also emailed when ready. Does not return raw notification analytics; use get_analytics for that.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "projectId": { "description": "Project id. Optional when a personal token pins the project or exactly one project is available in the approved workspace.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "refresh": { "description": "Pass refresh: true only when the user asks for a new report; when checking on a pending report, call without refresh. Reuses an open request, otherwise returns the latest report if it was ready within the last 24 hours, or requests a new one.", "type": "boolean" } }, "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Get lifecycle report" } }, { "name": "get_recommendations", "title": "Get recommendations", "description": "Side effect: creates a preparation request when no report is ready or refresh is true and the latest report became ready more than 24 hours ago; repeat calls reuse an open request. Pass refresh: true only when the user asks for a new report; when checking on a pending report, call without refresh. Use for Dreamlit's prioritized recommendations on which emails or workflows to add and what to fix or change in existing ones. Available on Pro and Scale plans only. Reports are prepared by Dreamlit's agents and reviewed by our team. Returns a ready report or a processing state while Dreamlit prepares it; check back later. The requester is also emailed when ready. Does not return raw notification analytics; use get_analytics for that.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "projectId": { "description": "Project id. Optional when a personal token pins the project or exactly one project is available in the approved workspace.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "refresh": { "description": "Pass refresh: true only when the user asks for a new report; when checking on a pending report, call without refresh. Reuses an open request, otherwise returns the latest report if it was ready within the last 24 hours, or requests a new one.", "type": "boolean" } }, "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Get recommendations" } }, { "name": "send_workflow_test", "title": "Send workflow test", "description": "Side effect when confirmSend is true: sends one current draft email or Slack message for review, but does not publish, schedule, or edit the workflow. Use after authoring or inspection when the user wants to verify an important message before publishing. Returns sent-test details, app URLs, a confirmation request, or a clarification request with user-facing message choices. If the test has no data because row level security hides a source table's rows from Dreamlit, returns error code table_rows_hidden_by_rls with unreadableTables[].fixSql to run, or ask the user to run, in the Supabase SQL editor. Do not expose test target ids as copy; ask users to choose by message label and confirm before sending.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "confirmSend": { "description": "Set to true only after the user explicitly confirms sending this selected test message. If omitted or false, Dreamlit returns confirmation_required and does not send.", "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Send workflow test" } }, { "name": "prepare_publish", "title": "Prepare publish", "description": "Read-only validation step before publishing. Use after the user asks to publish and after inspecting the workflow if needed. Returns validation status, publish mode, preview URL, and a confirmation payload with version/timestamp safety checks for confirm_publish. Does not publish or schedule anything by itself.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "workflowId": { "description": "Workflow id to validate and prepare for explicit publish approval.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Prepare publish" } }, { "name": "confirm_publish", "title": "Confirm publish", "description": "Use only after explicit user confirmation and a prior prepare_publish result to publish or schedule a Dreamlit workflow. Side effect: installs live database/repeating/auth triggers, schedules or sends broadcasts, and may enable notification delivery; sandbox mode can hold notifications for inspection. Returns the published workflow status and app URLs. Do not call speculatively or without carrying forward the prepare_publish safety fields.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Confirm publish" } }, { "name": "unpublish_workflow", "title": "Unpublish workflow", "description": "Use after explicit user intent to unpublish a Dreamlit workflow. Side effect: disables live triggers or schedules so no new runs start. Runs already in progress keep sending unless inProgressRuns is \"stop\". If the workflow has in-progress runs and inProgressRuns is omitted, returns clarification_required with the count and changes nothing: ask the user whether to stop those runs or let them finish, then call again with their choice. Returns updated workflow status, stopped run counts (allRunsStopped, remainingRunCount), and app URLs. If some runs could not be stopped, ask the user, then call again with inProgressRuns \"stop\": on an already-unpublished workflow it only stops the runs still in progress. Do not use for deleting drafts, canceling one broadcast run, or editing workflow content.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "inProgressRuns": { "description": "What happens to runs already in progress, including runs waiting at a wait step. \"stop\" stops them so they send nothing more; \"let_finish\" lets them keep going and send. Required when the workflow has in-progress runs: ask the user, then call again with their choice. On an already-unpublished workflow, \"stop\" stops the runs still in progress.", "enum": [ "stop", "let_finish" ], "type": "string" }, "workflowId": { "description": "Workflow id to unpublish and disable live triggers or schedules.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "result": { "description": "Dreamlit MCP result. success responses contain data and appUrls when relevant; auth_required, clarification_required, confirmation_required, handoff_required, and error responses explain the next action.", "oneOf": [ { "additionalProperties": false, "properties": { "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "auth": { "additionalProperties": false, "properties": { "reason": { "type": "string" } }, "required": [ "reason" ], "type": "object" }, "message": { "type": "string" }, "status": { "const": "auth_required", "type": "string" } }, "required": [ "status", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "clarification": { "anyOf": [ { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "workflows" ], "type": "object" }, "assistantMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "chatSessionId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "userMessageId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "message", "workflowId", "projectId", "orgId", "chatSessionId", "userMessageId", "assistantMessageId", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "kind": { "const": "test_message_selection", "type": "string" }, "message": { "type": "string" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "testableMessages": { "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "destination": { "type": "string" }, "label": { "type": "string" }, "messageType": { "enum": [ "email", "slack" ], "type": "string" }, "requiresRecipient": { "type": "boolean" }, "testTargetId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "testTargetId", "messageType", "label", "requiresRecipient" ], "type": "object" }, "minItems": 2, "type": "array" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "testableMessages", "appUrls" ], "type": "object" }, { "additionalProperties": false, "properties": { "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "inProgressRunCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "const": "unpublish_in_progress_runs", "type": "string" }, "message": { "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "inProgressRuns": { "enum": [ "stop", "let_finish" ], "type": "string" }, "label": { "type": "string" }, "recommended": { "type": "boolean" } }, "required": [ "inProgressRuns", "label", "recommended" ], "type": "object" }, "type": "array" }, "orgId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "projectId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "kind", "message", "workflowId", "projectId", "orgId", "inProgressRunCount", "options", "appUrls" ], "type": "object" } ] }, "status": { "const": "clarification_required", "type": "string" } }, "required": [ "status", "clarification" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "anyOf": [ { "additionalProperties": false, "properties": { "action": { "const": "confirm_publish", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "expectedEditableVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Editable version id returned by prepare_publish, used as a safety check." }, "expectedPublishedVersionId": { "anyOf": [ { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, { "type": "null" } ], "description": "Published version id returned by prepare_publish, used as a safety check." }, "expectedUpdatedAtIso": { "anyOf": [ { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, { "type": "null" } ], "description": "Workflow updatedAt timestamp returned by prepare_publish, used as a safety check." }, "isSandboxed": { "description": "Whether to publish in sandbox mode so notifications are held for inspection.", "type": "boolean" }, "workflowId": { "description": "Workflow id to publish.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId" ], "type": "object" }, "kind": { "const": "publish", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "summary", "warnings" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "send_workflow_test", "type": "string" }, "appUrls": { "additionalProperties": false, "properties": { "preview": { "format": "uri", "type": "string" }, "workflow": { "format": "uri", "type": "string" }, "workflows": { "format": "uri", "type": "string" } }, "required": [ "workflow", "preview" ], "type": "object" }, "input": { "additionalProperties": false, "properties": { "confirmSend": { "const": true, "type": "boolean" }, "messageType": { "description": "Optional message type filter when selecting a draft message to test.", "enum": [ "email", "slack" ], "type": "string" }, "rowData": { "additionalProperties": {}, "description": "Optional sample data for rendering draft message variables during the test. If omitted, Dreamlit uses the same default preview data as the web builder when available.", "propertyNames": { "type": "string" }, "type": "object" }, "testRecipientEmail": { "description": "Optional recipient for email tests. If omitted, Dreamlit sends to the authenticated user's email address.", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "testTargetId": { "description": "Structured test target id from testableMessages. Do not show this id to users; ask them to choose by message label.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "workflowId": { "description": "Workflow id whose editable draft message should be tested.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } }, "required": [ "workflowId", "confirmSend" ], "type": "object" }, "kind": { "const": "send_workflow_test", "type": "string" }, "message": { "type": "string" }, "previewUrl": { "format": "uri", "type": "string" }, "summary": { "items": { "type": "string" }, "type": "array" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "action", "input", "message", "previewUrl", "appUrls", "summary", "warnings" ], "type": "object" } ] }, "status": { "const": "confirmation_required", "type": "string" } }, "required": [ "status", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "handoff": { "additionalProperties": false, "properties": { "blocker": { "additionalProperties": false, "description": "Why Dreamlit stopped before finishing the draft. Changes counted in appliedActionCount are already saved.", "properties": { "appliedActionCount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "step_needs_detail: answer `detail` in a follow-up create_or_update_workflow call with the same workflowId. step_not_editable: change a different step instead. step_not_built: retry once, then finish in the browser. request_unclear: describe the change in more detail and retry.", "enum": [ "step_needs_detail", "step_not_editable", "step_not_built", "request_unclear" ], "type": "string" }, "detail": { "description": "The specific missing detail or blocking rule, in plain language.", "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "database_trigger", "broadcast_trigger", "repeating_trigger", "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "code", "detail", "appliedActionCount" ], "type": "object" }, "instructions": { "items": { "type": "string" }, "type": "array" }, "kind": { "const": "browser", "type": "string" }, "message": { "type": "string" }, "reason": { "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "kind", "reason", "message", "url", "instructions" ], "type": "object" }, "status": { "const": "handoff_required", "type": "string" } }, "required": [ "status", "handoff" ], "type": "object" }, { "additionalProperties": false, "properties": { "billingUrl": { "description": "quota_exceeded or plan_upgrade_required: page where a workspace admin can buy AI credits or upgrade the plan.", "format": "uri", "type": "string" }, "code": { "type": "string" }, "helpUrl": { "description": "Guide or support contact for resolving the problem in the message.", "format": "uri", "type": "string" }, "message": { "type": "string" }, "resetAt": { "description": "quota_exceeded: when this month's AI usage resets (ISO 8601).", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "error", "type": "string" }, "stepEdits": { "description": "edit_workflow_steps: what happened to each edit when none could be applied.", "items": { "additionalProperties": false, "properties": { "changedFields": { "items": { "type": "string" }, "type": "array" }, "error": { "additionalProperties": false, "properties": { "code": { "description": "step_not_found: get fresh step ids from get_workflow_and_preview_url. step_not_editable: triggers can't be edited here; use create_or_update_workflow. field_not_for_step_type: send only fields for that step's type. duplicate_step: combine edits to one step. invalid_value: fix the value as the message says. query_failed: fix the SQL. query_drops_used_fields: keep returning fields, or edit the steps that use them in the same call. related_edit_failed: a related edit in this call (a SQL edit above or below this step) failed; fix it and send both again. save_failed: try again.", "enum": [ "step_not_found", "step_not_editable", "field_not_for_step_type", "duplicate_step", "invalid_value", "query_failed", "query_drops_used_fields", "related_edit_failed", "save_failed" ], "type": "string" }, "fields": { "description": "query_drops_used_fields: fields later steps still use that the new query no longer returns.", "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "index": { "description": "Position of the edit in the request.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "enum": [ "applied", "failed" ], "type": "string" }, "stepId": { "type": "string" }, "stepTitle": { "type": "string" }, "stepType": { "enum": [ "query", "wait", "email", "slack" ], "type": "string" } }, "required": [ "index", "stepId", "status", "changedFields" ], "type": "object" }, "type": "array" }, "unreadableTables": { "description": "table_rows_hidden_by_rls: tables Dreamlit can see but not read rows from, each with fixSql that adds Dreamlit's read policy. Run fixSql, or ask the user to run it, in the Supabase SQL editor, then try again.", "items": { "additionalProperties": false, "properties": { "fixSql": { "type": "string" }, "schema": { "type": "string" }, "table": { "type": "string" } }, "required": [ "schema", "table", "fixSql" ], "type": "object" }, "type": "array" } }, "required": [ "status", "message" ], "type": "object" } ] } }, "required": [ "result" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Unpublish workflow" } } ], "schemaTokens": 69715, "changedAt": "2026-11-07T01:43:51.385315264Z", "check": { "checker": "anchor-check/1.0", "totalTokens": 69715, "counts": { "error": 0, "note": 0, "warn": 18 }, "findings": [ { "rule": "TC18", "severity": "warn", "tool": "prepare_publish", "message": "readOnlyHint is true but the name says \"publish\"", "fix": "If it changes anything, readOnlyHint must be false." }, { "rule": "TC22", "severity": "warn", "tool": "confirm_publish", "message": "the definition is about 4,360 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "create_or_update_workflow", "message": "the definition is about 4,866 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "edit_workflow_steps", "message": "the definition is about 4,839 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "get_analytics", "message": "the definition is about 5,580 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "get_lifecycle_report", "message": "the definition is about 4,217 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "get_recommendations", "message": "the definition is about 4,188 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "get_status", "message": "the definition is about 4,209 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "get_workflow_and_preview_url", "message": "the definition is about 4,164 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "list_brand_styles", "message": "the definition is about 4,071 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "list_projects", "message": "the definition is about 3,956 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "list_workflows", "message": "the definition is about 4,289 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "move_workflow_to_folder", "message": "the definition is about 4,148 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "prepare_publish", "message": "the definition is about 3,999 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "rename_workflow", "message": "the definition is about 4,022 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "send_workflow_test", "message": "the definition is about 4,420 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "unpublish_workflow", "message": "the definition is about 4,231 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC23", "severity": "warn", "message": "16 tools, about 69,559 tokens of definitions", "fix": "Split the server by job, or offer a smaller default toolset (a read-only set, or a search-then-call pattern)." } ] } }, "updatedAt": "2026-11-07T19:22:04.196961592Z" } }, "edges": [ { "by": 18, "category": "security", "leads": "dreamlit", "name": "Security \u0026 auth", "reasons": { "a": "Up to 100 named account passcodes with optional expiry, shown once and deletable, or per-user passcodes an admin can reset and revoke. No scopes or OAuth were found, and the secret travels in a header (22). No read-only passcode was found. The docs say campaigns created via API are not restricted by RBAC settings. A dashboard approval workflow exists, and `draft` lets an API caller save without sending (6). The API returns customer-supplied profile and event content, and no guidance for agents reading it was found (3). Audit logs record API key creation and revocation and API access logs, with CSV download and a daily export for SIEM tools (13). ISO/IEC 27001, ISO/IEC 27017, SOC 2 Type II, CSA STAR Level 2 and HIPAA are named on the pricing and security pages. The pricing page, re-read on 4 November, still names ISO/IEC 27001, ISO/IEC 27017, SOC 2 Type II and CSA STAR Level 2 and says reports are on the trust portal. clevertap.com/.well-known/security.txt answered 404 on 4 November, no disclosure policy or bug bounty was found, and the trust portal answered 403 on 9 October (12). Total 56.", "b": "OAuth to one workspace with four scopes, and project-scoped personal access tokens with chosen scopes, shown once (30). A read-only grant is possible, publishing needs its own scope, `confirm_publish` runs only after the user approves the prepared payload, and a dedicated least-privilege database user reads the customer's data (20). The docs warn that AI clients can be tricked by untrusted prompts and tell users to review edit, publish and unpublish calls (8 of 15). The security page lists access logs for database operations and for the platform, and analytics expose run rows; no customer-facing log of MCP calls was described (8 of 15). The security page claims penetration testing and a bug bounty programme without a link, SOC 2 is coming soon, no security.txt (404), and the MCP repository's SECURITY.md routes reports to support (8 of 20). Total 74." }, "scores": { "a": 56, "b": 74 } }, { "by": 15, "category": "payments", "leads": "clevertap", "name": "Payments \u0026 pricing", "reasons": { "a": "No x402, MPP or L402 (0). The Core plan's entry price is public at 85 dollars a month, re-read on 4 November, for up to 5,000 monthly active users. The larger tiers were not readable and Pro and Ultimate need a demo, so this is plan-only pricing (10). Core has a 30-day free trial. The account docs say billing details are needed before the last seven days, so 5 of the 20 points come off (15). A person signs up in a browser and creates the passcode in the dashboard (0). Total 25.", "b": "No x402, MPP or L402 (0). Plan prices with included emails are public in pricing.md, no per-email overage price (10 of 20). No free plan for new accounts (0). Signup, database connection and payment happen in the web app (0). Total 10." }, "scores": { "a": 25, "b": 10 } }, { "by": 14, "category": "reliability", "leads": "dreamlit", "name": "Reliability", "reasons": { "a": "Graded on the REST API, with the hosted lines. No status page is linked from the home page, the pricing, security, terms or privacy pages or either docs index, re-read on 4 November, and no address was guessed (0). With no page there is no readable incident history, which this run scores 5 (from 0). Concurrent request limits are published with numbers for 23 API groups (15 on uploads, 3 elsewhere) with 1,000 records a call, re-read on 4 November, but the Create Campaign page gives 3 requests a second, per the 9 October check, and the Get User Profiles page, re-read on 4 November, says limits are account-specific (13). HTTP 429 is in the errors table, re-read on 4 November, and the Get User Profiles page asks for exponential backoff of 1 to 16 seconds with at most 5 retries and says a cursor survives a timeout. That page, re-read on 4 November (updated 3 July 2026), still gives the backoff schedule for 429, 500 and 503. No Retry-After header and no idempotency key or safe-retry guidance for writes were found, so this run's value for backoff guidance alone applies (10, from 8). The terms, re-read on 4 November, leave service levels to each order, and no SLA is published (0). The API is generally available, with the External Trigger API in Public Beta, per the 9 October check (9). 0+5+13+10+0+9 = 37.", "b": "Graded with the hosted lines. A Better Stack status page at status.dreamlit.ai with 90 days of history for the Web App and the Workflow Engine, but no component for the MCP server (16 of 20). The record shows 100% for the web app and 99.992% for the workflow engine over 90 days, about ten minutes, with no written incidents (25 of 30). No rate limits found in the MCP or pricing docs (0). No 429, retry or idempotency guidance found (0). Scale includes dedicated support with an SLA and Enterprise has custom SLAs, but no published availability commitment (0). The MCP server, introduced on 5 May 2026, carries no beta label (10). Total 51." }, "scores": { "a": 37, "b": 51 } }, { "by": 14, "category": "ergonomics", "leads": "dreamlit", "name": "Agent ergonomics", "reasons": { "a": "Get User Profiles takes `batch_size` and `app`, `events` and `profile` flags, and reports take date ranges. No field selection was found (12). Profiles and events page by cursor with `next_cursor`, valid for 4 days. Get Campaigns filters only by date range and lists only API-created campaigns (14). Errors use `status`, `error` and `code` with per-API code lists and per-record results on uploads, but Get User Profiles returns some throttling errors with HTTP 200 (13). No idempotency key was found. `dryRun=1` validates uploads, `estimate_only` and `draft` hold a campaign back, and stopping a stopped campaign returns success (8). One current server library, Node.js `clevertap` 1.3.1. The linked Python wrapper was last changed in 2017 (6). Total 53.", "b": "16 tools, the 11 to 30 band; tools follow the granted scopes, so a read-only grant sees fewer (20 of 25). Analytics take filters, sorting and pagination, and brand styles paginate (18 of 20). The docs describe the errors an agent will meet, such as authorization required, choose a project and browser hand-off, without codes (12 of 20). Publishing is prepare then confirm, and tests don't publish; no idempotency or annotations documented (10 of 20). Empty scope requests default to the v1 scopes and `get_status` gives a first call; no SDK or REST route (7 of 15). Total 67." }, "scores": { "a": 53, "b": 67 } }, { "by": 7, "category": "maintenance", "leads": "dreamlit", "name": "Maintenance \u0026 community", "reasons": { "a": "The Web SDK tagged v3.1.2 on 2 November 2026, and the iOS SDK 7.9.1 on 30 October (30). Since 6 August the Web SDK has tagged v3.0.0, v3.0.1, v3.0.2, v3.0.3, v3.1.0, v3.1.1 and v3.1.2, the Android SDK core 8.4.1, push templates 2.6.0 and core 8.5.0 with templates 2.7.0, and the iOS SDK 7.8.1, 7.8.2, 7.9.0 and 7.9.1, read from clones on 4 November (20). Public monthly SDK changelogs (September 2026 is the newest page) and product release notes, with support through a dashboard ticket. GitHub issue handling was not read (9). Client SDKs are current. The Node.js server library's last release is still 1.3.1 (7 July 2026), and the Python wrapper dates from 2017 (10). The Node.js library ships a Travis CI file and depends on node-fetch 2. Its CI state was not read (4). 30+20+9+10+4 = 73.", "b": "The latest changelog entry is 12 October 2026, custom repeating schedules (30). Eight dated entries between 10 August and 12 October (20). Priority support on Pro, dedicated support on Scale and a public changelog (10 of 15). ai.dreamlit/mcp is in the official MCP registry under its domain namespace (15). The metadata repository has validate and publish workflows; there's no package to check (5 of 10). Total 80." }, "scores": { "a": 73, "b": 80 } }, { "by": 7, "category": "transparency", "leads": "clevertap", "name": "Transparency \u0026 trust", "reasons": { "a": "Closed service with public Terms of Service, last updated 30 April 2021 and re-read on 4 November, that name WizRocket Inc. and state the restrictions plainly (15). The privacy policy of 9 April 2026, unchanged on 4 November, covers CleverTap as processor, with deletion within 60 days of termination, and the docs give three years' default retention on Core and backup deletion within 60 days. The Data Processing Addendum the policy cites was not found in public (22). No API deprecation policy was found. The only dated notice read is the 2021 end of TLS 1.1 (3). Six hosting regions are documented and AWS is named as host. The sub-processor list sits on the trust portal, which answered 403 and was not read (10). Total 50.", "b": "A closed service under terms that name Notika AI (d/b/a Dreamlit AI) (15 of 30). The privacy policy keeps workflow execution history and delivery events for up to a year, while the security docs say Dreamlit retains no copy of customer data and cleans up after processing, which don't agree (15 of 30). No deprecation policy or dated notices found (0). The privacy policy points to a current subprocessor list and SCCs in a DPA, and names the United States and other countries as locations (12 of 20). Total 42." }, "scores": { "a": 66, "b": 59 } } ], "facts": [ { "a": "HTTP API", "b": "MCP server", "name": "Kind" }, { "a": "WizRocket Inc.", "b": "Notika AI", "name": "Vendor" }, { "a": "no (local only)", "b": "https://mcp.dreamlit.ai/mcp", "name": "Hosted endpoint" }, { "a": "HTTP", "b": "Streamable HTTP", "name": "Transports" }, { "a": "API key", "b": "OAuth", "name": "Auth" }, { "a": "Paid", "b": "Paid", "name": "Pricing" }, { "a": "no", "b": "no", "name": "x402" }, { "a": "Proprietary service under CleverTap's Terms of Service. The Node.js API library on GitHub is MIT", "b": "none", "name": "Licence" }, { "a": "none", "b": "16", "name": "Tools exposed" }, { "a": "no", "b": "no", "name": "Read-only variant documented" }, { "a": "yes", "b": "yes", "name": "llms.txt" }, { "a": "not listed", "b": "ai.dreamlit/mcp", "name": "MCP registry" }, { "a": "2026-10-01", "b": "2026-10-12", "name": "Last release" }, { "a": "2021-04-30", "b": "2026-01-29", "name": "Terms last updated" }, { "a": "2026-04-09", "b": "2026-01-29", "name": "Privacy policy last updated" }, { "a": "not found in the text", "b": "not found in the text", "name": "Customer content may train models" }, { "a": "not found in the text", "b": "not found in the text", "name": "Terms restrict automated access" }, { "a": "yes", "b": "not found in the text", "name": "Terms restrict benchmarking" }, { "a": "not found in the text", "b": "not found in the text", "name": "Terms or service can change without notice" }, { "a": "not found in the text", "b": "yes", "name": "Arbitration or class-action waiver" }, { "a": "3k npm/wk", "b": "none", "name": "Popularity" } ], "faq": [ { "answer": "Dreamlit scores 57 (C) on agent readiness against CleverTap's 50.4 (D), and leads in 5 of 7 scored categories. CleverTap leads on payments \u0026 pricing and transparency \u0026 trust.", "question": "Which is better for AI agents, CleverTap or Dreamlit?" }, { "answer": "CleverTap needs an API key. Dreamlit uses an OAuth sign-in.", "question": "Do CleverTap and Dreamlit need an API key?" }, { "answer": "No hosted endpoint is listed for CleverTap. Dreamlit has a hosted endpoint at https://mcp.dreamlit.ai/mcp.", "question": "Can an agent call CleverTap and Dreamlit without installing anything?" } ], "goodFor": [ { "aheadOn": [ "Payments \u0026 pricing, 25 against 10", "Transparency \u0026 trust, 66 against 59" ], "also": null, "goodFor": "A team already on CleverTap that wants an agent to load profiles and events, read them back, create or stop API campaigns and pull campaign reports.", "slug": "clevertap", "watchFor": "No OpenAPI file was found. The contract is prose tables plus a Postman collection published as a zip on GitHub" }, { "aheadOn": [ "Reliability, 51 against 37", "Agent ergonomics, 67 against 53", "Security \u0026 auth, 74 against 56", "Maintenance \u0026 community, 80 against 73" ], "also": [ "A hosted endpoint, with nothing to install" ], "goodFor": "Small product teams on Supabase or Postgres who want their coding agent to build lifecycle and transactional email workflows.", "slug": "dreamlit", "watchFor": "No REST API, SDK or OpenAPI; the MCP server is the only programmatic route" } ], "history": { "clevertap": [ { "causes": [ "correction" ], "date": "2026-11-04", "delta": 1.4, "from": 49, "fromGrade": "D", "to": 50.4, "toGrade": "D" }, { "causes": [ "method" ], "date": "2026-10-27", "delta": 0.2, "from": 48.8, "fromGrade": "D", "to": 49, "toGrade": "D" } ], "dreamlit": null }, "job": { "capability": "marketing.events", "name": "Marketing events" }, "others": [ { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-clevertap.json", "title": "ActiveCampaign vs CleverTap", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-clevertap" }, { "json": "https://www.anchorterminal.com/compare/braze-vs-clevertap.json", "title": "Braze vs CleverTap", "url": "https://www.anchorterminal.com/compare/braze-vs-clevertap" }, { "json": "https://www.anchorterminal.com/compare/clevertap-vs-customer-io.json", "title": "CleverTap vs Customer.io", "url": "https://www.anchorterminal.com/compare/clevertap-vs-customer-io" }, { "json": "https://www.anchorterminal.com/compare/clevertap-vs-iterable.json", "title": "CleverTap vs Iterable", "url": "https://www.anchorterminal.com/compare/clevertap-vs-iterable" }, { "json": "https://www.anchorterminal.com/compare/clevertap-vs-klaviyo.json", "title": "CleverTap vs Klaviyo API + MCP", "url": "https://www.anchorterminal.com/compare/clevertap-vs-klaviyo" }, { "json": "https://www.anchorterminal.com/compare/clevertap-vs-mailchimp-marketing.json", "title": "CleverTap vs Mailchimp Marketing API", "url": "https://www.anchorterminal.com/compare/clevertap-vs-mailchimp-marketing" }, { "json": "https://www.anchorterminal.com/compare/clevertap-vs-moengage.json", "title": "CleverTap vs MoEngage", "url": "https://www.anchorterminal.com/compare/clevertap-vs-moengage" }, { "json": "https://www.anchorterminal.com/compare/clevertap-vs-nitrosend.json", "title": "CleverTap vs Nitrosend", "url": "https://www.anchorterminal.com/compare/clevertap-vs-nitrosend" }, { "json": "https://www.anchorterminal.com/compare/clevertap-vs-omnisend.json", "title": "CleverTap vs Omnisend", "url": "https://www.anchorterminal.com/compare/clevertap-vs-omnisend" }, { "json": "https://www.anchorterminal.com/compare/clevertap-vs-sequenzy.json", "title": "CleverTap vs Sequenzy", "url": "https://www.anchorterminal.com/compare/clevertap-vs-sequenzy" }, { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-dreamlit.json", "title": "ActiveCampaign vs Dreamlit", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-dreamlit" }, { "json": "https://www.anchorterminal.com/compare/braze-vs-dreamlit.json", "title": "Braze vs Dreamlit", "url": "https://www.anchorterminal.com/compare/braze-vs-dreamlit" }, { "json": "https://www.anchorterminal.com/compare/customer-io-vs-dreamlit.json", "title": "Customer.io vs Dreamlit", "url": "https://www.anchorterminal.com/compare/customer-io-vs-dreamlit" }, { "json": "https://www.anchorterminal.com/compare/dreamlit-vs-iterable.json", "title": "Dreamlit vs Iterable", "url": "https://www.anchorterminal.com/compare/dreamlit-vs-iterable" }, { "json": "https://www.anchorterminal.com/compare/dreamlit-vs-klaviyo.json", "title": "Dreamlit vs Klaviyo API + MCP", "url": "https://www.anchorterminal.com/compare/dreamlit-vs-klaviyo" }, { "json": "https://www.anchorterminal.com/compare/dreamlit-vs-mailchimp-marketing.json", "title": "Dreamlit vs Mailchimp Marketing API", "url": "https://www.anchorterminal.com/compare/dreamlit-vs-mailchimp-marketing" }, { "json": "https://www.anchorterminal.com/compare/dreamlit-vs-moengage.json", "title": "Dreamlit vs MoEngage", "url": "https://www.anchorterminal.com/compare/dreamlit-vs-moengage" }, { "json": "https://www.anchorterminal.com/compare/dreamlit-vs-nitrosend.json", "title": "Dreamlit vs Nitrosend", "url": "https://www.anchorterminal.com/compare/dreamlit-vs-nitrosend" }, { "json": "https://www.anchorterminal.com/compare/dreamlit-vs-omnisend.json", "title": "Dreamlit vs Omnisend", "url": "https://www.anchorterminal.com/compare/dreamlit-vs-omnisend" }, { "json": "https://www.anchorterminal.com/compare/dreamlit-vs-sequenzy.json", "title": "Dreamlit vs Sequenzy", "url": "https://www.anchorterminal.com/compare/dreamlit-vs-sequenzy" } ], "panel": null, "scores": [ { "by": 14, "clevertap": 37, "dreamlit": 51, "edge": "dreamlit", "key": "reliability", "name": "Reliability", "weight": 16 }, { "key": "performance", "name": "Performance", "pending": true, "weight": 10 }, { "by": 2, "clevertap": 57, "dreamlit": 59, "edge": "dreamlit", "key": "schema", "name": "Schema \u0026 documentation", "weight": 13 }, { "by": 14, "clevertap": 53, "dreamlit": 67, "edge": "dreamlit", "key": "ergonomics", "name": "Agent ergonomics", "weight": 13 }, { "by": 18, "clevertap": 56, "dreamlit": 74, "edge": "dreamlit", "key": "security", "name": "Security \u0026 auth", "weight": 14 }, { "by": 15, "clevertap": 25, "dreamlit": 10, "edge": "clevertap", "key": "payments", "name": "Payments \u0026 pricing", "weight": 10 }, { "key": "tasks", "name": "Task success", "pending": true, "weight": 10 }, { "by": 7, "clevertap": 73, "dreamlit": 80, "edge": "dreamlit", "key": "maintenance", "name": "Maintenance \u0026 community", "weight": 7 }, { "by": 7, "clevertap": 66, "dreamlit": 59, "edge": "clevertap", "key": "transparency", "name": "Transparency \u0026 trust", "weight": 7 } ], "summary": "Dreamlit scores 57 (C) on agent readiness against CleverTap's 50.4 (D), and leads in 5 of 7 scored categories. CleverTap leads on payments \u0026 pricing and transparency \u0026 trust. Both do marketing events.", "tasks": null, "tutorials": [], "verdicts": { "clevertap": "CleverTap's REST API uploads and reads profiles and events, creates and stops campaigns and reports results, with Markdown docs, numeric concurrency limits and a 30-day Core trial. No OpenAPI file or public status page was found, passcodes carry no scopes, and the docs say campaigns created through the API are not restricted by role-based access control.", "dreamlit": "Scoped OAuth and a two-step prepare-then-confirm publish let an agent draft and test lifecycle workflows without sending anything live by mistake. There is no REST API or published rate limit, tool schemas aren't public outside a session, there's no free plan, and its security page and privacy policy disagree on retention." } }, "kind": "anchor.page", "links": { "api": "https://www.anchorterminal.com/api/v1/index.json", "html": "https://www.anchorterminal.com/compare/clevertap-vs-dreamlit", "json": "https://www.anchorterminal.com/compare/clevertap-vs-dreamlit.json", "llms": "https://www.anchorterminal.com/llms.txt", "markdown": "https://www.anchorterminal.com/compare/clevertap-vs-dreamlit.md", "mcp": "https://www.anchorterminal.com/mcp", "slim": "https://www.anchorterminal.com/compare/clevertap-vs-dreamlit.min.md" }, "markdown": "Dreamlit scores 57 (C) on agent readiness against CleverTap's 50.4 (D), and leads in 5 of 7 scored categories. CleverTap leads on payments \u0026 pricing and transparency \u0026 trust. Both do marketing events.\n\n- CleverTap: grade D, 50.4/100, rank #1066 of 1510. Markdown https://www.anchorterminal.com/tools/clevertap.md · JSON https://www.anchorterminal.com/api/v1/tools/clevertap.json\n- Dreamlit: grade C, 57/100, rank #813 of 1510. Markdown https://www.anchorterminal.com/tools/dreamlit.md · JSON https://www.anchorterminal.com/api/v1/tools/dreamlit.json\n- Best lifecycle marketing and customer engagement platforms for AI agents: https://www.anchorterminal.com/best/lifecycle-marketing/index.md\n- All 66 lifecycle marketing comparisons: https://www.anchorterminal.com/compare/lifecycle-marketing/index.md\n\n## Which one, for what\n\n### CleverTap (D)\n\nGood for: A team already on CleverTap that wants an agent to load profiles and events, read them back, create or stop API campaigns and pull campaign reports.\n\nAhead on:\n- Payments \u0026 pricing, 25 against 10\n- Transparency \u0026 trust, 66 against 59\n\nWatch for: No OpenAPI file was found. The contract is prose tables plus a Postman collection published as a zip on GitHub\n\n### Dreamlit (C)\n\nGood for: Small product teams on Supabase or Postgres who want their coding agent to build lifecycle and transactional email workflows.\n\nAhead on:\n- Reliability, 51 against 37\n- Agent ergonomics, 67 against 53\n- Security \u0026 auth, 74 against 56\n- Maintenance \u0026 community, 80 against 73\n\nAlso in its favour:\n- A hosted endpoint, with nothing to install\n\nWatch for: No REST API, SDK or OpenAPI; the MCP server is the only programmatic route\n\n\n## Why the edge\n\n### Security \u0026 auth: Dreamlit +18\n\n- CleverTap (56): Up to 100 named account passcodes with optional expiry, shown once and deletable, or per-user passcodes an admin can reset and revoke. No scopes or OAuth were found, and the secret travels in a header (22). No read-only passcode was found. The docs say campaigns created via API are not restricted by RBAC settings. A dashboard approval workflow exists, and `draft` lets an API caller save without sending (6). The API returns customer-supplied profile and event content, and no guidance for agents reading it was found (3). Audit logs record API key creation and revocation and API access logs, with CSV download and a daily export for SIEM tools (13). ISO/IEC 27001, ISO/IEC 27017, SOC 2 Type II, CSA STAR Level 2 and HIPAA are named on the pricing and security pages. The pricing page, re-read on 4 November, still names ISO/IEC 27001, ISO/IEC 27017, SOC 2 Type II and CSA STAR Level 2 and says reports are on the trust portal. clevertap.com/.well-known/security.txt answered 404 on 4 November, no disclosure policy or bug bounty was found, and the trust portal answered 403 on 9 October (12). Total 56.\n- Dreamlit (74): OAuth to one workspace with four scopes, and project-scoped personal access tokens with chosen scopes, shown once (30). A read-only grant is possible, publishing needs its own scope, `confirm_publish` runs only after the user approves the prepared payload, and a dedicated least-privilege database user reads the customer's data (20). The docs warn that AI clients can be tricked by untrusted prompts and tell users to review edit, publish and unpublish calls (8 of 15). The security page lists access logs for database operations and for the platform, and analytics expose run rows; no customer-facing log of MCP calls was described (8 of 15). The security page claims penetration testing and a bug bounty programme without a link, SOC 2 is coming soon, no security.txt (404), and the MCP repository's SECURITY.md routes reports to support (8 of 20). Total 74.\n\n### Payments \u0026 pricing: CleverTap +15\n\n- CleverTap (25): No x402, MPP or L402 (0). The Core plan's entry price is public at 85 dollars a month, re-read on 4 November, for up to 5,000 monthly active users. The larger tiers were not readable and Pro and Ultimate need a demo, so this is plan-only pricing (10). Core has a 30-day free trial. The account docs say billing details are needed before the last seven days, so 5 of the 20 points come off (15). A person signs up in a browser and creates the passcode in the dashboard (0). Total 25.\n- Dreamlit (10): No x402, MPP or L402 (0). Plan prices with included emails are public in pricing.md, no per-email overage price (10 of 20). No free plan for new accounts (0). Signup, database connection and payment happen in the web app (0). Total 10.\n\n### Reliability: Dreamlit +14\n\n- CleverTap (37): Graded on the REST API, with the hosted lines. No status page is linked from the home page, the pricing, security, terms or privacy pages or either docs index, re-read on 4 November, and no address was guessed (0). With no page there is no readable incident history, which this run scores 5 (from 0). Concurrent request limits are published with numbers for 23 API groups (15 on uploads, 3 elsewhere) with 1,000 records a call, re-read on 4 November, but the Create Campaign page gives 3 requests a second, per the 9 October check, and the Get User Profiles page, re-read on 4 November, says limits are account-specific (13). HTTP 429 is in the errors table, re-read on 4 November, and the Get User Profiles page asks for exponential backoff of 1 to 16 seconds with at most 5 retries and says a cursor survives a timeout. That page, re-read on 4 November (updated 3 July 2026), still gives the backoff schedule for 429, 500 and 503. No Retry-After header and no idempotency key or safe-retry guidance for writes were found, so this run's value for backoff guidance alone applies (10, from 8). The terms, re-read on 4 November, leave service levels to each order, and no SLA is published (0). The API is generally available, with the External Trigger API in Public Beta, per the 9 October check (9). 0+5+13+10+0+9 = 37.\n- Dreamlit (51): Graded with the hosted lines. A Better Stack status page at status.dreamlit.ai with 90 days of history for the Web App and the Workflow Engine, but no component for the MCP server (16 of 20). The record shows 100% for the web app and 99.992% for the workflow engine over 90 days, about ten minutes, with no written incidents (25 of 30). No rate limits found in the MCP or pricing docs (0). No 429, retry or idempotency guidance found (0). Scale includes dedicated support with an SLA and Enterprise has custom SLAs, but no published availability commitment (0). The MCP server, introduced on 5 May 2026, carries no beta label (10). Total 51.\n\n### Agent ergonomics: Dreamlit +14\n\n- CleverTap (53): Get User Profiles takes `batch_size` and `app`, `events` and `profile` flags, and reports take date ranges. No field selection was found (12). Profiles and events page by cursor with `next_cursor`, valid for 4 days. Get Campaigns filters only by date range and lists only API-created campaigns (14). Errors use `status`, `error` and `code` with per-API code lists and per-record results on uploads, but Get User Profiles returns some throttling errors with HTTP 200 (13). No idempotency key was found. `dryRun=1` validates uploads, `estimate_only` and `draft` hold a campaign back, and stopping a stopped campaign returns success (8). One current server library, Node.js `clevertap` 1.3.1. The linked Python wrapper was last changed in 2017 (6). Total 53.\n- Dreamlit (67): 16 tools, the 11 to 30 band; tools follow the granted scopes, so a read-only grant sees fewer (20 of 25). Analytics take filters, sorting and pagination, and brand styles paginate (18 of 20). The docs describe the errors an agent will meet, such as authorization required, choose a project and browser hand-off, without codes (12 of 20). Publishing is prepare then confirm, and tests don't publish; no idempotency or annotations documented (10 of 20). Empty scope requests default to the v1 scopes and `get_status` gives a first call; no SDK or REST route (7 of 15). Total 67.\n\n### Maintenance \u0026 community: Dreamlit +7\n\n- CleverTap (73): The Web SDK tagged v3.1.2 on 2 November 2026, and the iOS SDK 7.9.1 on 30 October (30). Since 6 August the Web SDK has tagged v3.0.0, v3.0.1, v3.0.2, v3.0.3, v3.1.0, v3.1.1 and v3.1.2, the Android SDK core 8.4.1, push templates 2.6.0 and core 8.5.0 with templates 2.7.0, and the iOS SDK 7.8.1, 7.8.2, 7.9.0 and 7.9.1, read from clones on 4 November (20). Public monthly SDK changelogs (September 2026 is the newest page) and product release notes, with support through a dashboard ticket. GitHub issue handling was not read (9). Client SDKs are current. The Node.js server library's last release is still 1.3.1 (7 July 2026), and the Python wrapper dates from 2017 (10). The Node.js library ships a Travis CI file and depends on node-fetch 2. Its CI state was not read (4). 30+20+9+10+4 = 73.\n- Dreamlit (80): The latest changelog entry is 12 October 2026, custom repeating schedules (30). Eight dated entries between 10 August and 12 October (20). Priority support on Pro, dedicated support on Scale and a public changelog (10 of 15). ai.dreamlit/mcp is in the official MCP registry under its domain namespace (15). The metadata repository has validate and publish workflows; there's no package to check (5 of 10). Total 80.\n\n### Transparency \u0026 trust: CleverTap +7\n\n- CleverTap (66): Closed service with public Terms of Service, last updated 30 April 2021 and re-read on 4 November, that name WizRocket Inc. and state the restrictions plainly (15). The privacy policy of 9 April 2026, unchanged on 4 November, covers CleverTap as processor, with deletion within 60 days of termination, and the docs give three years' default retention on Core and backup deletion within 60 days. The Data Processing Addendum the policy cites was not found in public (22). No API deprecation policy was found. The only dated notice read is the 2021 end of TLS 1.1 (3). Six hosting regions are documented and AWS is named as host. The sub-processor list sits on the trust portal, which answered 403 and was not read (10). Total 50.\n- Dreamlit (59): A closed service under terms that name Notika AI (d/b/a Dreamlit AI) (15 of 30). The privacy policy keeps workflow execution history and delivery events for up to a year, while the security docs say Dreamlit retains no copy of customer data and cleans up after processing, which don't agree (15 of 30). No deprecation policy or dated notices found (0). The privacy policy points to a current subprocessor list and SCCs in a DPA, and names the United States and other countries as locations (12 of 20). Total 42.\n\n## Score by category\n\n| Category | Weight | CleverTap | Dreamlit | Edge |\n| --- | --- | --- | --- | --- |\n| Reliability | 16% (20 this run) | 37 | 51 | Dreamlit +14 |\n| Performance | 10%, pending | pending | pending | not scored in this run |\n| Schema \u0026 documentation | 13% (16.2 this run) | 57 | 59 | Dreamlit +2 |\n| Agent ergonomics | 13% (16.2 this run) | 53 | 67 | Dreamlit +14 |\n| Security \u0026 auth | 14% (17.5 this run) | 56 | 74 | Dreamlit +18 |\n| Payments \u0026 pricing | 10% (12.5 this run) | 25 | 10 | CleverTap +15 |\n| Task success | 10%, pending | pending | pending | not scored in this run |\n| Maintenance \u0026 community | 7% (8.8 this run) | 73 | 80 | Dreamlit +7 |\n| Transparency \u0026 trust | 7% (8.8 this run) | 66 | 59 | CleverTap +7 |\n| Negative events | ≤15 | 0 | 0 | |\n| **Total** | | **50.4 · D** | **57 · C** | |\n\n## Facts side by side\n\n| Fact | CleverTap | Dreamlit |\n| --- | --- | --- |\n| Kind | HTTP API | MCP server |\n| Vendor | WizRocket Inc. | Notika AI |\n| Hosted endpoint | no (local only) | `https://mcp.dreamlit.ai/mcp` |\n| Transports | HTTP | Streamable HTTP |\n| Auth | API key | OAuth |\n| Pricing | Paid | Paid |\n| x402 | no | no |\n| Licence | Proprietary service under CleverTap's Terms of Service. The Node.js API library on GitHub is MIT | none |\n| Tools exposed | none | 16 |\n| Read-only variant documented | no | no |\n| llms.txt | yes | yes |\n| MCP registry | not listed | `ai.dreamlit/mcp` |\n| Last release | 2026-10-01 | 2026-10-12 |\n| Terms last updated | 2021-04-30 | 2026-01-29 |\n| Privacy policy last updated | 2026-04-09 | 2026-01-29 |\n| Customer content may train models | not found in the text | not found in the text |\n| Terms restrict automated access | not found in the text | not found in the text |\n| Terms restrict benchmarking | yes | not found in the text |\n| Terms or service can change without notice | not found in the text | not found in the text |\n| Arbitration or class-action waiver | not found in the text | yes |\n| Popularity | 3k npm/wk | none |\n\n## How the scores have moved\n\n### CleverTap\n\n- +1.4 on 4 November 2026: correction\n- +0.2 on 27 October 2026: checklist\n\n### Dreamlit\n\nNo score change since it was listed.\n\n## Verdicts\n\n**CleverTap.** CleverTap's REST API uploads and reads profiles and events, creates and stops campaigns and reports results, with Markdown docs, numeric concurrency limits and a 30-day Core trial. No OpenAPI file or public status page was found, passcodes carry no scopes, and the docs say campaigns created through the API are not restricted by role-based access control.\n\n**Dreamlit.** Scoped OAuth and a two-step prepare-then-confirm publish let an agent draft and test lifecycle workflows without sending anything live by mistake. There is no REST API or published rate limit, tool schemas aren't public outside a session, there's no free plan, and its security page and privacy policy disagree on retention.\n\n## Before you call either\n\n### CleverTap\n\n1. Call the host for the account's region, such as `in1.api.clevertap.com` or `us1.api.clevertap.com`. `api.clevertap.com` is the Europe region\n2. Send `X-CleverTap-Account-Id` and `X-CleverTap-Passcode` headers on every call, and ask for a named passcode with an expiry date\n3. Check `status` in the body as well as the HTTP code. Get User Profiles can answer 200 with `\"status\":\"fail\"` when throttled\n4. Add `dryRun=1` to an upload URL to validate up to 1,000 records without storing them\n5. Set `estimate_only` or `draft` to true on Create Campaign before a real send. API campaigns bypass dashboard role restrictions\n\n### Dreamlit\n\n1. Call `get_status` first to see the workspace, project setup state and prompting guidance\n2. Use `send_workflow_test` to the user before `prepare_publish`, and call `confirm_publish` only after the user approves the returned payload\n3. Request `workflows:read` and `analytics:read` only when the task is reporting, so the grant can't publish\n4. Expect a browser hand-off link when setup or an unsupported edit needs the web app, and pass it to the user\n\n## Questions\n\n### Which is better for AI agents, CleverTap or Dreamlit?\n\nDreamlit scores 57 (C) on agent readiness against CleverTap's 50.4 (D), and leads in 5 of 7 scored categories. CleverTap leads on payments \u0026 pricing and transparency \u0026 trust.\n\n### Do CleverTap and Dreamlit need an API key?\n\nCleverTap needs an API key. Dreamlit uses an OAuth sign-in.\n\n### Can an agent call CleverTap and Dreamlit without installing anything?\n\nNo hosted endpoint is listed for CleverTap. Dreamlit has a hosted endpoint at https://mcp.dreamlit.ai/mcp.\n\n\n## For agents\n\n- This comparison as JSON: https://www.anchorterminal.com/compare/clevertap-vs-dreamlit.json, and with the fewest tokens: https://www.anchorterminal.com/compare/clevertap-vs-dreamlit.min.md\n- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {\"a\": \"clevertap\", \"b\": \"dreamlit\"}`. From a terminal: `anchor compare clevertap dreamlit`\n- Each listing in full: https://www.anchorterminal.com/api/v1/tools/clevertap.json and https://www.anchorterminal.com/api/v1/tools/dreamlit.json\n\n## Other comparisons with CleverTap or Dreamlit\n\n- [ActiveCampaign vs CleverTap](https://www.anchorterminal.com/compare/activecampaign-vs-clevertap.md)\n- [Braze vs CleverTap](https://www.anchorterminal.com/compare/braze-vs-clevertap.md)\n- [CleverTap vs Customer.io](https://www.anchorterminal.com/compare/clevertap-vs-customer-io.md)\n- [CleverTap vs Iterable](https://www.anchorterminal.com/compare/clevertap-vs-iterable.md)\n- [CleverTap vs Klaviyo API + MCP](https://www.anchorterminal.com/compare/clevertap-vs-klaviyo.md)\n- [CleverTap vs Mailchimp Marketing API](https://www.anchorterminal.com/compare/clevertap-vs-mailchimp-marketing.md)\n- [CleverTap vs MoEngage](https://www.anchorterminal.com/compare/clevertap-vs-moengage.md)\n- [CleverTap vs Nitrosend](https://www.anchorterminal.com/compare/clevertap-vs-nitrosend.md)\n- [CleverTap vs Omnisend](https://www.anchorterminal.com/compare/clevertap-vs-omnisend.md)\n- [CleverTap vs Sequenzy](https://www.anchorterminal.com/compare/clevertap-vs-sequenzy.md)\n- [ActiveCampaign vs Dreamlit](https://www.anchorterminal.com/compare/activecampaign-vs-dreamlit.md)\n- [Braze vs Dreamlit](https://www.anchorterminal.com/compare/braze-vs-dreamlit.md)\n- [Customer.io vs Dreamlit](https://www.anchorterminal.com/compare/customer-io-vs-dreamlit.md)\n- [Dreamlit vs Iterable](https://www.anchorterminal.com/compare/dreamlit-vs-iterable.md)\n- [Dreamlit vs Klaviyo API + MCP](https://www.anchorterminal.com/compare/dreamlit-vs-klaviyo.md)\n- [Dreamlit vs Mailchimp Marketing API](https://www.anchorterminal.com/compare/dreamlit-vs-mailchimp-marketing.md)\n- [Dreamlit vs MoEngage](https://www.anchorterminal.com/compare/dreamlit-vs-moengage.md)\n- [Dreamlit vs Nitrosend](https://www.anchorterminal.com/compare/dreamlit-vs-nitrosend.md)\n- [Dreamlit vs Omnisend](https://www.anchorterminal.com/compare/dreamlit-vs-omnisend.md)\n- [Dreamlit vs Sequenzy](https://www.anchorterminal.com/compare/dreamlit-vs-sequenzy.md)\n", "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "attributionRequired": true, "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-11-07", "license": "CC-BY-4.0", "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.7", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run", "terms": "https://www.anchorterminal.com/terms/#data" }, "page": { "breadcrumbs": [ { "name": "Home", "url": "https://www.anchorterminal.com/" }, { "name": "Compare", "url": "https://www.anchorterminal.com/compare/" }, { "name": "CleverTap vs Dreamlit", "url": "" } ], "description": "Dreamlit scores 57 (C) to CleverTap's 50.4 (D) for marketing events. Prices, MCP, x402, uptime and agent notes side by side.", "facts": [ "CleverTap D 50.4", "Dreamlit C 57", "scores" ], "h1": "CleverTap vs Dreamlit", "image": "https://www.anchorterminal.com/assets/og/default.png", "path": "/compare/clevertap-vs-dreamlit", "published": "2026-10-01", "section": "tools", "title": "CleverTap vs Dreamlit for AI agents in 2026: scores and prices", "toc": null, "updated": "2026-11-07", "url": "https://www.anchorterminal.com/compare/clevertap-vs-dreamlit" }, "tokens": { "markdown": 4600, "slim": 2880 }, "version": 1 }