{ "data": { "a": { "slug": "activecampaign", "name": "ActiveCampaign", "vendor": "ActiveCampaign, LLC", "vendorUrl": "https://www.activecampaign.com", "kind": "http-api", "category": "lifecycle-marketing", "summary": "ActiveCampaign is a hosted marketing automation platform for email, SMS and WhatsApp with a built-in CRM. Its v3 REST API and an official remote MCP server cover contacts, lists, tags, segments, campaigns, automations and deals.", "url": "https://www.anchorterminal.com/tools/activecampaign", "markdownUrl": "https://www.anchorterminal.com/tools/activecampaign.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/activecampaign.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/activecampaign.json", "dns": "activecampaign.grade.anchorterminal.com", "license": "Proprietary service under ActiveCampaign's terms of service and API licence agreement", "transports": [ "http", "streamable-http" ], "packages": [], "auth": "mixed", "authNotes": "Self-serve. The REST API takes an `Api-Token` header, and each user has one key, shown under Settings, Developer with the account's base URL. No scopes, read-only keys or OAuth for the REST API were found in the reviewed documentation. The remote MCP server uses an account-specific URL from the same page, and the user signs in to ActiveCampaign and approves the connection. Event tracking posts an event key and account ID in the request body.", "pricing": "paid", "pricingNotes": "14-day trial with no card, and a free developer sandbox on request by form (1,000 contacts, 100 email sends, 5 users, two years), per the 8 October check. No free plan. Plans are priced by contact count. The 8 October prices came from a data file the pricing page loads, which this benchmark no longer reads, and the page wasn't re-read on 4 November 2026 because the terms bar automated access.", "priceSummary": "Paid", "where": "local", "x402": { "level": "no", "evidence": "No x402, MPP or L402 in the developer docs or on the pricing page (checked 2026-10-08).", "endpoints": [] }, "toolCount": 50, "popularity": { "githubStars": null, "npmWeekly": null, "pypiWeekly": null, "asOf": "2026-10-08" }, "docsUrl": "https://developers.activecampaign.com/reference/overview", "llmsTxt": "https://developers.activecampaign.com/llms.txt", "capabilities": [ "marketing.profiles", "marketing.events", "marketing.segments", "marketing.campaigns", "marketing.journeys", "crm.records", "crm.pipeline", "crm.webhooks", "messaging.sms", "messaging.whatsapp" ], "tags": [ "official", "hosted", "closed-source", "mcp", "api-key", "llms-txt", "openapi", "webhooks", "no-card", "trial", "sandbox", "status-page", "sla", "sms", "whatsapp" ], "lastRelease": "2026-09-02", "graded": true, "anchor": { "graded": true, "score": 43.9, "grade": "E", "agentReady": false, "rank": 1223, "ranked": true, "rankOf": 1486, "categoryRank": 12, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 52, "maintenance": 5, "payments": 20, "reliability": 52, "schema": 68, "security": 33, "transparency": 60 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "low", "date": "2026-11-04" }, "negative": 0, "verdict": "The v3 REST API covers contacts, segments, campaign scheduling and bulk import, with OpenAPI 3.1 definitions inside public Markdown reference pages and documented Retry-After on 429s. Each user has one unscoped API key, the limit is 5 requests a second, no changelog was found, and the official PHP and Node.js clients date from 2017 and 2018.", "bestFor": "Small and mid-sized teams already on ActiveCampaign that want an agent to maintain contacts, segments and campaign drafts and enrol contacts in automations.", "strengths": [ "Every reference page is served as Markdown with an OpenAPI 3.1 definition for its operation, indexed by llms.txt", "429 responses carry Retry-After, RateLimit-Limit and RateLimit-Remaining headers per the rate limit page", "Contact upsert by email and bulk import of 250 contacts a request make contact writes safe to repeat", "Official remote MCP server with 50 listed tools and no delete tool, included on all four plans per the pricing page", "A 99.5 per cent availability SLA is published for enterprise subscriptions, and the sub-processor list of 25 September 2026 names locations" ], "weaknesses": [ "No readable incident history. The status page sits on ActiveCampaign's own domain, whose terms bar robots, and its earlier reading came from a data feed", "One API key per user with no scopes or read-only keys in the reviewed documentation", "The limit is 5 requests a second per account on every plan", "No public API changelog or deprecation policy was found, and developers.activecampaign.com/changelog returns 404", "The official PHP and Node.js clients wrap the v1 API and last changed in December 2017 and March 2018" ], "agentNotes": [ "Take the base URL from Settings, Developer in the account. Do not build it from the account name, because non-US accounts may not sit on api-us1.com", "Use POST /contact/sync to upsert by email, and POST /import/bulk_import for up to 250 contacts, then read each row's outcome from GET /import/info", "Page large contact sets with `orders[id]=ASC` and `id_greater`, not `offset`. Unsupported filter and order keys are silently ignored", "Check `succeeded` in the body after scheduling, pausing or stopping a campaign. Business-rule failures return 200 with `succeeded` set to 0", "Stay under 5 requests a second per account and wait for the Retry-After value on a 429" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "low", "grade": "E", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 43.9 } ], "editorialScores": { "ergonomics": 52, "maintenance": 5, "payments": 20, "reliability": 52, "schema": 68, "security": 33, "transparency": 55 }, "provenanceScore": 64, "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": { "http": "curl -H \"Api-Token: $ACTIVECAMPAIGN_API_TOKEN\" https://\u003caccount\u003e.api-us1.com/api/3/users/me" }, "letme": { "capability": "https://letme.dev/marketing.profiles", "tool": "https://letme.dev/activecampaign" }, "area": "communication", "provenance": { "legalEntity": "ActiveCampaign, LLC", "domain": "activecampaign.com", "domainRegistered": "2003-01-10", "endpointOnVendorDomain": false, "terms": "https://www.activecampaign.com/legal/terms-of-service", "privacy": "https://www.activecampaign.com/legal/privacy-policy", "statusPage": "https://status.activecampaign.com", "changelog": "", "securityTxt": "none", "checked": "2026-11-04", "notes": [ "The terms of service (last updated 19 October 2026) name ActiveCampaign, LLC and cover its websites, applications and other services. Section 8 excludes data mining, robots and similar data-gathering methods from the licence.", "The API answers at https://\u003caccount\u003e.api-us1.com/api/3 and event tracking at https://trackcmp.net/event, neither on activecampaign.com. The docs name both hosts (per the 8 October check).", "www.activecampaign.com/.well-known/security.txt and /security.txt returned 404 on 8 October 2026, not re-read.", "developers.activecampaign.com/changelog returned 404 on 8 October 2026 and no other API changelog was found.", "The registration date is carried from the 8 October check, which took it from RDAP, a data service this run doesn't use; it has no first-hand source today.", "robots.txt sets a Crawl-delay of 1 and Content-Signal ai-train=yes, search=yes, ai-input=yes." ], "score": 64 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/activecampaign.json", "live": { "slug": "activecampaign", "vendorStatus": { "page": "https://status.activecampaign.com", "indicator": "none", "summary": "All Systems Operational", "checkedAt": "2026-11-07T18:20:31.638697348Z" }, "securityTxt": { "url": "https://activecampaign.com/.well-known/security.txt", "state": "none", "checkedAt": "2026-11-07T16:00:38.558209584Z" }, "llmsTxt": { "url": "https://developers.activecampaign.com/llms.txt", "ok": true, "status": 200, "checkedAt": "2026-11-07T15:31:04.74227875Z" }, "domain": { "domain": "activecampaign.com", "registered": "2003-01-10", "source": "https://rdap.verisign.com/com/v1/domain/activecampaign.com", "checkedAt": "2026-11-01T14:25:42.85662222Z" }, "pages": [ { "url": "https://www.activecampaign.com/pricing", "kind": "pricing", "status": 200, "checkedAt": "2026-11-04T08:36:32.186298524Z", "changedAt": "2026-11-04T08:36:32.186298524Z", "fingerprint": "e568c5258ccf" }, { "url": "https://www.activecampaign.com/legal/privacy-policy", "kind": "privacy", "status": 200, "checkedAt": "2026-11-07T14:24:09.993770715Z", "changedAt": "2026-11-04T08:36:27.042116758Z", "fingerprint": "79f5bf1d075d" }, { "url": "https://www.activecampaign.com/legal/terms-of-service", "kind": "terms", "status": 200, "checkedAt": "2026-11-07T14:24:12.401839002Z", "changedAt": "2026-11-04T08:36:29.878885766Z", "fingerprint": "82c150302ae7" } ], "updatedAt": "2026-11-07T18:20:31.638697348Z" } }, "answer": "Dreamlit scores 57 (C) on agent readiness against ActiveCampaign's 43.9 (E), and leads in 3 of 7 scored categories. ActiveCampaign leads on schema \u0026 documentation and payments \u0026 pricing.", "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": 809, "ranked": true, "rankOf": 1486, "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-07T18:20:21.651954632Z", "lastOk": true, "lastStatus": 200, "lastMs": 209, "lastNote": "initialize answered", "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 155, "p95ms24h": 303, "samples24h": 200, "samples30d": 200, "days": [ { "date": "2026-11-06", "probes": 13, "ok": 13 }, { "date": "2026-11-07", "probes": 187, "ok": 187 } ] }, "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-07T18:20:21.651954632Z" } }, "edges": [ { "by": 75, "category": "maintenance", "leads": "dreamlit", "name": "Maintenance \u0026 community", "reasons": { "a": "There is no changelog. On 8 October the `updatedAt` stamps on 46 of the 185 reference pages fell on 12, 13, 17 and 31 August and 2 September 2026 (per the 8 October check, not re-read on 4 November). The 8 October check recorded them as page revisions, not changelog entries, and no API change was recorded on those pages. Page dates that record no change don't set recency (as wrike, coinbase-mcp and agentweb), and the clients are years old, so no dated API change is readable (0). Page stamps aren't releases, so the 90-day line is 0. No public changelog. A community site and a developer relations email address are published, and we did not see reply times (5). The official PHP and Node.js clients are v1 wrappers last changed in December 2017 and March 2018 (0). No current package to assess (0). 0 + 0 + 5 + 0 + 0 = 5.", "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": 5, "b": 80 } }, { "by": 41, "category": "security", "leads": "dreamlit", "name": "Security \u0026 auth", "reasons": { "a": "One API key per user in an `Api-Token` header, with no scopes. The MCP server is authorised by signing in and approving, with no scopes documented. Key rotation was not found in the reviewed documentation (15 of 30). No read-only key or mode. The listed MCP tools include no delete tool and none that schedules a campaign, though `add_contact_to_automation` can start messages, and the definitions name a permission resource for each operation (8 of 20). The API returns contact data, notes and message content written by outsiders, and no prompt-injection guidance was found (0 of 15). No audit log or per-call visibility was found in the developer docs. The help centre refused our reader, so this is unchecked (0 of 15). The security page states SOC 2, HIPAA and GDPR compliance, a red team and a trust centre with the SOC 2 report. No security.txt, bug bounty or disclosure policy was found (10 of 20). All per the 8 October check, not re-read on 4 November. robots.txt disallows `/security/bounty`, so whether a bounty page exists wasn't read.", "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": 33, "b": 74 } }, { "by": 15, "category": "ergonomics", "leads": "dreamlit", "name": "Agent ergonomics", "reasons": { "a": "List endpoints take `limit` up to 100 and contacts take `meta=only` for a count, but there is no field selection. The MCP server lists 50 tools with no documented toolsets (12 of 25). `limit`, `offset`, `orders`, `filters` and `id_greater` on contacts, less 4 because unsupported filter and order keys are silently ignored (16 of 20). Five documented status codes and a 422 `errors` array of titles without codes. Campaign state changes report failures as 200 with `succeeded` 0 and a localised message (10 of 20). No idempotency keys. Upsert by email and bulk import with per-row status give safe retries for contacts, and no MCP tool annotations are documented (8 of 20). Few required parameters. The official PHP and Node.js clients wrap the v1 API and last changed in 2017 and 2018, so no current official SDK was found (6 of 15). Docs per the 8 October check, not re-read on 4 November; the PHP client's last commit (7 December 2017) was confirmed from a clone.", "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": 52, "b": 67 } }, { "by": 10, "category": "payments", "leads": "activecampaign", "name": "Payments \u0026 pricing", "reasons": { "a": "No x402, MPP or L402 (0). The 8 October plan prices were read from a data file the pricing page loads, which this run doesn't use, and the pricing page wasn't re-read on 4 November because the terms bar automated access, so no published price is counted (0). A 14-day trial with no card, and a free developer sandbox on request (per the 8 October check, not re-read on 4 November) (20). A person signs up in a browser and copies the key from account settings (0). 0 + 0 + 20 + 0 = 20.", "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": 20, "b": 10 } }, { "by": 9, "category": "schema", "leads": "activecampaign", "name": "Schema \u0026 documentation", "reasons": { "a": "Each reference page is public Markdown with an OpenAPI 3.1 definition for its operation. No single downloadable specification was found (20 of 25). llms.txt and Markdown pages (10). Pages revised in August 2026, such as contact upsert and contact search, say when to use each endpoint and when not to. Older pages are short, and the MCP page gives one line a tool with no input schemas (14 of 20). Query parameters are typed with enums on status and sort order, but the segment body is described as flexible JSON to be checked against the segment builder (10 of 15). Request examples on most pages. The errors page lists five status codes and one 422 body, and 400 responses in the definitions are empty objects (9 of 15). The version is in the path (v3, Segments 2.0.0). No changelog was found, and developers.activecampaign.com/changelog returns 404 (5 of 15). All per the 8 October check, not re-read on 4 November, since the terms bar automated access to the developer site.", "b": "The registry entry and the dreamlit-ai/dreamlit-mcp repository carry metadata only, so tool JSON Schemas are readable only inside a session; the docs give each tool's purpose and required scope (5 of 25). llms.txt, pricing.md and Markdown copies of docs pages (10). Tool descriptions say when to use each, such as `edit_workflow_steps` for exact edits without AI, and the publish pair's order (16 of 20). Parameter types aren't published beyond names such as `includeEmailHtml` and `startNewChat` (5 of 15). Example prompts and a troubleshooting section for each documented error state (10 of 15). A dated changelog; server version 0.1.0 in the registry (13 of 15). Total 59." }, "scores": { "a": 68, "b": 59 } } ], "facts": [ { "a": "HTTP API", "b": "MCP server", "name": "Kind" }, { "a": "ActiveCampaign, LLC", "b": "Notika AI", "name": "Vendor" }, { "a": "no (local only)", "b": "https://mcp.dreamlit.ai/mcp", "name": "Hosted endpoint" }, { "a": "HTTP, Streamable HTTP", "b": "Streamable HTTP", "name": "Transports" }, { "a": "OAuth or key", "b": "OAuth", "name": "Auth" }, { "a": "Paid", "b": "Paid", "name": "Pricing" }, { "a": "no", "b": "no", "name": "x402" }, { "a": "Proprietary service under ActiveCampaign's terms of service and API licence agreement", "b": "none", "name": "Licence" }, { "a": "50", "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-09-02", "b": "2026-10-12", "name": "Last release" }, { "a": "2025-12-23", "b": "2026-01-29", "name": "Terms last updated" }, { "a": "2026-10-01", "b": "2026-01-29", "name": "Privacy policy last updated" }, { "a": "yes", "b": "not found in the text", "name": "Customer content may train models" }, { "a": "yes", "b": "not found in the text", "name": "Terms restrict automated access" }, { "a": "not found in the text", "b": "not found in the text", "name": "Terms restrict benchmarking" }, { "a": "yes", "b": "not found in the text", "name": "Terms or service can change without notice" }, { "a": "yes", "b": "yes", "name": "Arbitration or class-action waiver" } ], "faq": [ { "answer": "Dreamlit scores 57 (C) on agent readiness against ActiveCampaign's 43.9 (E), and leads in 3 of 7 scored categories. ActiveCampaign leads on schema \u0026 documentation and payments \u0026 pricing.", "question": "Which is better for AI agents, ActiveCampaign or Dreamlit?" }, { "answer": "ActiveCampaign takes an API key or an OAuth sign-in. Dreamlit uses an OAuth sign-in.", "question": "Do ActiveCampaign and Dreamlit need an API key?" }, { "answer": "No hosted endpoint is listed for ActiveCampaign. Dreamlit has a hosted endpoint at https://mcp.dreamlit.ai/mcp.", "question": "Can an agent call ActiveCampaign and Dreamlit without installing anything?" } ], "goodFor": [ { "aheadOn": [ "Schema \u0026 documentation, 68 against 59", "Payments \u0026 pricing, 20 against 10" ], "also": [ "Free to start without a card" ], "goodFor": "Small and mid-sized teams already on ActiveCampaign that want an agent to maintain contacts, segments and campaign drafts and enrol contacts in automations.", "slug": "activecampaign", "watchFor": "No readable incident history. The status page sits on ActiveCampaign's own domain, whose terms bar robots, and its earlier reading came from a data feed" }, { "aheadOn": [ "Agent ergonomics, 67 against 52", "Security \u0026 auth, 74 against 33", "Maintenance \u0026 community, 80 against 5" ], "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": { "activecampaign": [ { "causes": [ "correction", "method" ], "date": "2026-11-04", "delta": -6.8, "from": 50.7, "fromGrade": "D", "to": 43.9, "toGrade": "E" }, { "causes": [ "method" ], "date": "2026-10-27", "delta": 0.2, "from": 50.5, "fromGrade": "D", "to": 50.7, "toGrade": "D" } ], "dreamlit": null }, "job": { "capability": "marketing.journeys", "name": "Marketing journeys" }, "others": [ { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-braze.json", "title": "ActiveCampaign vs Braze", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-braze" }, { "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/activecampaign-vs-customer-io.json", "title": "ActiveCampaign vs Customer.io", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-customer-io" }, { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-iterable.json", "title": "ActiveCampaign vs Iterable", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-iterable" }, { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-klaviyo.json", "title": "ActiveCampaign vs Klaviyo API + MCP", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-klaviyo" }, { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-mailchimp-marketing.json", "title": "ActiveCampaign vs Mailchimp Marketing API", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-mailchimp-marketing" }, { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-moengage.json", "title": "ActiveCampaign vs MoEngage", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-moengage" }, { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-nitrosend.json", "title": "ActiveCampaign vs Nitrosend", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-nitrosend" }, { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-omnisend.json", "title": "ActiveCampaign vs Omnisend", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-omnisend" }, { "json": "https://www.anchorterminal.com/compare/activecampaign-vs-sequenzy.json", "title": "ActiveCampaign vs Sequenzy", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-sequenzy" }, { "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" }, { "json": "https://www.anchorterminal.com/compare/clevertap-vs-dreamlit.json", "title": "CleverTap vs Dreamlit", "url": "https://www.anchorterminal.com/compare/clevertap-vs-dreamlit" } ], "panel": null, "scores": [ { "activecampaign": 52, "by": 1, "dreamlit": 51, "edge": "activecampaign", "key": "reliability", "name": "Reliability", "weight": 16 }, { "key": "performance", "name": "Performance", "pending": true, "weight": 10 }, { "activecampaign": 68, "by": 9, "dreamlit": 59, "edge": "activecampaign", "key": "schema", "name": "Schema \u0026 documentation", "weight": 13 }, { "activecampaign": 52, "by": 15, "dreamlit": 67, "edge": "dreamlit", "key": "ergonomics", "name": "Agent ergonomics", "weight": 13 }, { "activecampaign": 33, "by": 41, "dreamlit": 74, "edge": "dreamlit", "key": "security", "name": "Security \u0026 auth", "weight": 14 }, { "activecampaign": 20, "by": 10, "dreamlit": 10, "edge": "activecampaign", "key": "payments", "name": "Payments \u0026 pricing", "weight": 10 }, { "key": "tasks", "name": "Task success", "pending": true, "weight": 10 }, { "activecampaign": 5, "by": 75, "dreamlit": 80, "edge": "dreamlit", "key": "maintenance", "name": "Maintenance \u0026 community", "weight": 7 }, { "activecampaign": 60, "by": 1, "dreamlit": 59, "edge": "activecampaign", "key": "transparency", "name": "Transparency \u0026 trust", "weight": 7 } ], "summary": "Dreamlit scores 57 (C) on agent readiness against ActiveCampaign's 43.9 (E), and leads in 3 of 7 scored categories. ActiveCampaign leads on schema \u0026 documentation and payments \u0026 pricing. Both do marketing journeys.", "tasks": null, "tutorials": [], "verdicts": { "activecampaign": "The v3 REST API covers contacts, segments, campaign scheduling and bulk import, with OpenAPI 3.1 definitions inside public Markdown reference pages and documented Retry-After on 429s. Each user has one unscoped API key, the limit is 5 requests a second, no changelog was found, and the official PHP and Node.js clients date from 2017 and 2018.", "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/activecampaign-vs-dreamlit", "json": "https://www.anchorterminal.com/compare/activecampaign-vs-dreamlit.json", "llms": "https://www.anchorterminal.com/llms.txt", "markdown": "https://www.anchorterminal.com/compare/activecampaign-vs-dreamlit.md", "mcp": "https://www.anchorterminal.com/mcp", "slim": "https://www.anchorterminal.com/compare/activecampaign-vs-dreamlit.min.md" }, "markdown": "Dreamlit scores 57 (C) on agent readiness against ActiveCampaign's 43.9 (E), and leads in 3 of 7 scored categories. ActiveCampaign leads on schema \u0026 documentation and payments \u0026 pricing. Both do marketing journeys.\n\n- ActiveCampaign: grade E, 43.9/100, rank #1223 of 1486. Markdown https://www.anchorterminal.com/tools/activecampaign.md · JSON https://www.anchorterminal.com/api/v1/tools/activecampaign.json\n- Dreamlit: grade C, 57/100, rank #809 of 1486. 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### ActiveCampaign (E)\n\nGood for: Small and mid-sized teams already on ActiveCampaign that want an agent to maintain contacts, segments and campaign drafts and enrol contacts in automations.\n\nAhead on:\n- Schema \u0026 documentation, 68 against 59\n- Payments \u0026 pricing, 20 against 10\n\nAlso in its favour:\n- Free to start without a card\n\nWatch for: No readable incident history. The status page sits on ActiveCampaign's own domain, whose terms bar robots, and its earlier reading came from a data feed\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- Agent ergonomics, 67 against 52\n- Security \u0026 auth, 74 against 33\n- Maintenance \u0026 community, 80 against 5\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### Maintenance \u0026 community: Dreamlit +75\n\n- ActiveCampaign (5): There is no changelog. On 8 October the `updatedAt` stamps on 46 of the 185 reference pages fell on 12, 13, 17 and 31 August and 2 September 2026 (per the 8 October check, not re-read on 4 November). The 8 October check recorded them as page revisions, not changelog entries, and no API change was recorded on those pages. Page dates that record no change don't set recency (as wrike, coinbase-mcp and agentweb), and the clients are years old, so no dated API change is readable (0). Page stamps aren't releases, so the 90-day line is 0. No public changelog. A community site and a developer relations email address are published, and we did not see reply times (5). The official PHP and Node.js clients are v1 wrappers last changed in December 2017 and March 2018 (0). No current package to assess (0). 0 + 0 + 5 + 0 + 0 = 5.\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### Security \u0026 auth: Dreamlit +41\n\n- ActiveCampaign (33): One API key per user in an `Api-Token` header, with no scopes. The MCP server is authorised by signing in and approving, with no scopes documented. Key rotation was not found in the reviewed documentation (15 of 30). No read-only key or mode. The listed MCP tools include no delete tool and none that schedules a campaign, though `add_contact_to_automation` can start messages, and the definitions name a permission resource for each operation (8 of 20). The API returns contact data, notes and message content written by outsiders, and no prompt-injection guidance was found (0 of 15). No audit log or per-call visibility was found in the developer docs. The help centre refused our reader, so this is unchecked (0 of 15). The security page states SOC 2, HIPAA and GDPR compliance, a red team and a trust centre with the SOC 2 report. No security.txt, bug bounty or disclosure policy was found (10 of 20). All per the 8 October check, not re-read on 4 November. robots.txt disallows `/security/bounty`, so whether a bounty page exists wasn't read.\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### Agent ergonomics: Dreamlit +15\n\n- ActiveCampaign (52): List endpoints take `limit` up to 100 and contacts take `meta=only` for a count, but there is no field selection. The MCP server lists 50 tools with no documented toolsets (12 of 25). `limit`, `offset`, `orders`, `filters` and `id_greater` on contacts, less 4 because unsupported filter and order keys are silently ignored (16 of 20). Five documented status codes and a 422 `errors` array of titles without codes. Campaign state changes report failures as 200 with `succeeded` 0 and a localised message (10 of 20). No idempotency keys. Upsert by email and bulk import with per-row status give safe retries for contacts, and no MCP tool annotations are documented (8 of 20). Few required parameters. The official PHP and Node.js clients wrap the v1 API and last changed in 2017 and 2018, so no current official SDK was found (6 of 15). Docs per the 8 October check, not re-read on 4 November; the PHP client's last commit (7 December 2017) was confirmed from a clone.\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### Payments \u0026 pricing: ActiveCampaign +10\n\n- ActiveCampaign (20): No x402, MPP or L402 (0). The 8 October plan prices were read from a data file the pricing page loads, which this run doesn't use, and the pricing page wasn't re-read on 4 November because the terms bar automated access, so no published price is counted (0). A 14-day trial with no card, and a free developer sandbox on request (per the 8 October check, not re-read on 4 November) (20). A person signs up in a browser and copies the key from account settings (0). 0 + 0 + 20 + 0 = 20.\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### Schema \u0026 documentation: ActiveCampaign +9\n\n- ActiveCampaign (68): Each reference page is public Markdown with an OpenAPI 3.1 definition for its operation. No single downloadable specification was found (20 of 25). llms.txt and Markdown pages (10). Pages revised in August 2026, such as contact upsert and contact search, say when to use each endpoint and when not to. Older pages are short, and the MCP page gives one line a tool with no input schemas (14 of 20). Query parameters are typed with enums on status and sort order, but the segment body is described as flexible JSON to be checked against the segment builder (10 of 15). Request examples on most pages. The errors page lists five status codes and one 422 body, and 400 responses in the definitions are empty objects (9 of 15). The version is in the path (v3, Segments 2.0.0). No changelog was found, and developers.activecampaign.com/changelog returns 404 (5 of 15). All per the 8 October check, not re-read on 4 November, since the terms bar automated access to the developer site.\n- Dreamlit (59): The registry entry and the dreamlit-ai/dreamlit-mcp repository carry metadata only, so tool JSON Schemas are readable only inside a session; the docs give each tool's purpose and required scope (5 of 25). llms.txt, pricing.md and Markdown copies of docs pages (10). Tool descriptions say when to use each, such as `edit_workflow_steps` for exact edits without AI, and the publish pair's order (16 of 20). Parameter types aren't published beyond names such as `includeEmailHtml` and `startNewChat` (5 of 15). Example prompts and a troubleshooting section for each documented error state (10 of 15). A dated changelog; server version 0.1.0 in the registry (13 of 15). Total 59.\n\n## Score by category\n\n| Category | Weight | ActiveCampaign | Dreamlit | Edge |\n| --- | --- | --- | --- | --- |\n| Reliability | 16% (20 this run) | 52 | 51 | ActiveCampaign +1 |\n| Performance | 10%, pending | pending | pending | not scored in this run |\n| Schema \u0026 documentation | 13% (16.2 this run) | 68 | 59 | ActiveCampaign +9 |\n| Agent ergonomics | 13% (16.2 this run) | 52 | 67 | Dreamlit +15 |\n| Security \u0026 auth | 14% (17.5 this run) | 33 | 74 | Dreamlit +41 |\n| Payments \u0026 pricing | 10% (12.5 this run) | 20 | 10 | ActiveCampaign +10 |\n| Task success | 10%, pending | pending | pending | not scored in this run |\n| Maintenance \u0026 community | 7% (8.8 this run) | 5 | 80 | Dreamlit +75 |\n| Transparency \u0026 trust | 7% (8.8 this run) | 60 | 59 | ActiveCampaign +1 |\n| Negative events | ≤15 | 0 | 0 | |\n| **Total** | | **43.9 · E** | **57 · C** | |\n\n## Facts side by side\n\n| Fact | ActiveCampaign | Dreamlit |\n| --- | --- | --- |\n| Kind | HTTP API | MCP server |\n| Vendor | ActiveCampaign, LLC | Notika AI |\n| Hosted endpoint | no (local only) | `https://mcp.dreamlit.ai/mcp` |\n| Transports | HTTP, Streamable HTTP | Streamable HTTP |\n| Auth | OAuth or key | OAuth |\n| Pricing | Paid | Paid |\n| x402 | no | no |\n| Licence | Proprietary service under ActiveCampaign's terms of service and API licence agreement | none |\n| Tools exposed | 50 | 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-09-02 | 2026-10-12 |\n| Terms last updated | 2025-12-23 | 2026-01-29 |\n| Privacy policy last updated | 2026-10-01 | 2026-01-29 |\n| Customer content may train models | yes | not found in the text |\n| Terms restrict automated access | yes | not found in the text |\n| Terms restrict benchmarking | not found in the text | not found in the text |\n| Terms or service can change without notice | yes | not found in the text |\n| Arbitration or class-action waiver | yes | yes |\n\n## How the scores have moved\n\n### ActiveCampaign\n\n- -6.8 on 4 November 2026 (D to E): correction, checklist\n- +0.2 on 27 October 2026: checklist\n\n### Dreamlit\n\nNo score change since it was listed.\n\n## Verdicts\n\n**ActiveCampaign.** The v3 REST API covers contacts, segments, campaign scheduling and bulk import, with OpenAPI 3.1 definitions inside public Markdown reference pages and documented Retry-After on 429s. Each user has one unscoped API key, the limit is 5 requests a second, no changelog was found, and the official PHP and Node.js clients date from 2017 and 2018.\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### ActiveCampaign\n\n1. Take the base URL from Settings, Developer in the account. Do not build it from the account name, because non-US accounts may not sit on api-us1.com\n2. Use POST /contact/sync to upsert by email, and POST /import/bulk_import for up to 250 contacts, then read each row's outcome from GET /import/info\n3. Page large contact sets with `orders[id]=ASC` and `id_greater`, not `offset`. Unsupported filter and order keys are silently ignored\n4. Check `succeeded` in the body after scheduling, pausing or stopping a campaign. Business-rule failures return 200 with `succeeded` set to 0\n5. Stay under 5 requests a second per account and wait for the Retry-After value on a 429\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, ActiveCampaign or Dreamlit?\n\nDreamlit scores 57 (C) on agent readiness against ActiveCampaign's 43.9 (E), and leads in 3 of 7 scored categories. ActiveCampaign leads on schema \u0026 documentation and payments \u0026 pricing.\n\n### Do ActiveCampaign and Dreamlit need an API key?\n\nActiveCampaign takes an API key or an OAuth sign-in. Dreamlit uses an OAuth sign-in.\n\n### Can an agent call ActiveCampaign and Dreamlit without installing anything?\n\nNo hosted endpoint is listed for ActiveCampaign. 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/activecampaign-vs-dreamlit.json, and with the fewest tokens: https://www.anchorterminal.com/compare/activecampaign-vs-dreamlit.min.md\n- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {\"a\": \"activecampaign\", \"b\": \"dreamlit\"}`. From a terminal: `anchor compare activecampaign dreamlit`\n- Each listing in full: https://www.anchorterminal.com/api/v1/tools/activecampaign.json and https://www.anchorterminal.com/api/v1/tools/dreamlit.json\n\n## Other comparisons with ActiveCampaign or Dreamlit\n\n- [ActiveCampaign vs Braze](https://www.anchorterminal.com/compare/activecampaign-vs-braze.md)\n- [ActiveCampaign vs CleverTap](https://www.anchorterminal.com/compare/activecampaign-vs-clevertap.md)\n- [ActiveCampaign vs Customer.io](https://www.anchorterminal.com/compare/activecampaign-vs-customer-io.md)\n- [ActiveCampaign vs Iterable](https://www.anchorterminal.com/compare/activecampaign-vs-iterable.md)\n- [ActiveCampaign vs Klaviyo API + MCP](https://www.anchorterminal.com/compare/activecampaign-vs-klaviyo.md)\n- [ActiveCampaign vs Mailchimp Marketing API](https://www.anchorterminal.com/compare/activecampaign-vs-mailchimp-marketing.md)\n- [ActiveCampaign vs MoEngage](https://www.anchorterminal.com/compare/activecampaign-vs-moengage.md)\n- [ActiveCampaign vs Nitrosend](https://www.anchorterminal.com/compare/activecampaign-vs-nitrosend.md)\n- [ActiveCampaign vs Omnisend](https://www.anchorterminal.com/compare/activecampaign-vs-omnisend.md)\n- [ActiveCampaign vs Sequenzy](https://www.anchorterminal.com/compare/activecampaign-vs-sequenzy.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- [CleverTap vs Dreamlit](https://www.anchorterminal.com/compare/clevertap-vs-dreamlit.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": "ActiveCampaign vs Dreamlit", "url": "" } ], "description": "Dreamlit scores 57 (C) to ActiveCampaign's 43.9 (E) for marketing journeys. Prices, MCP, x402, uptime and agent notes side by side.", "facts": [ "ActiveCampaign E 43.9", "Dreamlit C 57", "scores" ], "h1": "ActiveCampaign vs Dreamlit", "image": "https://www.anchorterminal.com/assets/og/default.png", "path": "/compare/activecampaign-vs-dreamlit", "published": "2026-10-01", "section": "tools", "title": "ActiveCampaign vs Dreamlit for AI agents in 2026: scores and prices", "toc": null, "updated": "2026-11-07", "url": "https://www.anchorterminal.com/compare/activecampaign-vs-dreamlit" }, "tokens": { "markdown": 4300, "slim": 2530 }, "version": 1 }