Vynflow exposes an official Model Context Protocol (MCP) endpoint, so AI agents can work in your workspace: manage user tables and rows, write contexts and instructions, design case models with steps, fields and branching, and open, fill and move cases forward. Every call runs with the service account's roles.
Official MCP endpoint:
https://vynflow.cloud/mcpCreate a service account for your workspace (Domains › Service accounts), then add the server. Claude Code:
claude mcp add --transport http vynflow https://vynflow.cloud/mcp \
--header "Authorization: Bearer sa-p-vynflow-SECRET" \
--header "X-API-Key: sa-k-vynflow-KEY" \
--header "X-Domain-ID: DOMAIN_UUID""confirm": "DELETE", so the agent has to check with you first.
Built-in guides (vynflow://mcp/case-modeling, vynflow://mcp/cases) teach agents the field types,
branching and value formats.
Tables, columns, rows and row links.
user_tables_list — List the workspace's user tables (paged, optional name search).user_tables_create — Create a user table. Add columns with user_tables_columns_create.user_tables_get_schema — A table and its columns (ids, names, types, options, relations). Read this before writing rows.user_tables_delete — Delete a table and all its rows (runs in the background).user_tables_columns_create — Add a column to a table.user_tables_columns_update — Rename or change a column. A type change converts stored values in the background.user_tables_columns_delete — Delete a column and its values in every row.user_tables_rows_list — List a table's rows with paging, filters and sorting.user_tables_rows_get — One row by id.user_tables_rows_create — Create a row. data maps column name → value.user_tables_rows_batch_create — Create several rows in one call.user_tables_rows_update — Replace a row's values (required columns must be present).user_tables_rows_patch — Change only the given columns of a row.user_tables_rows_batch_update — Update several rows by id; patch=true merges, false replaces.user_tables_rows_upsert — Insert or update rows, matched by id or by match_columns (business key).user_tables_rows_delete — Delete one row.user_tables_rows_batch_delete — Delete several rows of a table.user_tables_export_csv — The table's rows as CSV text.user_tables_rows_relations_list — Rows linked to a row through a relation column.user_tables_rows_relations_link — Link a row to another through a many-to-many relation column.user_tables_rows_relations_unlink — Remove a many-to-many link between two rows.user_tables_attachment_upload — Upload a file for a table's Attachment column. Returns the file id: set it as the column's value with user_tables_rows_create / _patch.Knowledge documents and their instructions.
contexts_list — Contexts in the workspace (without their content).contexts_get — A context with its content and instructions.contexts_create — Create a context, optionally with instructions and a linked case model.contexts_update — Change a context; case_model_id null unlinks; archived archives/restores.contexts_delete — Delete a context and its instructions.contexts_instructions_create — Append an instruction to a context.contexts_instructions_update — Change an instruction; archived archives/restores.contexts_instructions_delete — Delete an instruction.contexts_instructions_reorder — Put instructions in this order (unlisted ones follow).Steps, fields and branching.
case_models_list — Case models in the workspace.case_models_get — A case model with its steps (order, branching) and every step's fields.case_models_create — Create a case model with its steps, fields and branching in one call (see the case-modeling guide). Rolled back entirely if any step is invalid.case_models_update — Change a case model; null clears a link; archived archives/restores.case_models_delete — Delete a case model AND every case opened from it. Prefer archiving (case_models_update archived=true).case_models_steps_create — Append a step (with fields) to a case model. Reorder with case_models_steps_reorder.case_models_steps_update — Change a step's title, kind, branch options or lane; null clears branch_selector_id/branch_key/instruction_id.case_models_steps_delete — Delete a step and the data every case holds for it. Its lane steps (if a branch_choice) move to the main line.case_models_steps_reorder — Put steps in this order (unlisted ones follow).case_models_fields_create — Append a field to a step.case_models_fields_update — Change a field (only the given properties).case_models_fields_delete — Delete a field and its values in every case.case_models_fields_reorder — Put a step's fields in this order (unlisted ones follow).case_models_create_from_draft — Save an AI case-model draft (from assistant_case_model_draft) as a real case model, in one transaction.Values, branches, status, AI execution, reminders and checkpoints.
cases_list — Cases, newest activity first, with filters.cases_get — A case with its visible steps, field values, branch choices and progress.cases_create — Open a case from a case model, optionally filling field values.cases_update — Change a case's details and/or apply a status action.cases_set_values — Write field values into a case (same validation as the web editor).cases_select_branches — Choose the lane(s) a case takes at a branch_choice step; other lanes are cancelled.cases_ai_create — AI case execution: describe the case in plain words; the case assistant picks the case model (or uses case_model_id), opens the case and fills every step it can. Returns the case plus the run outcome, warnings and the required fields it could not fill. Consumes AI credits; can take a minute or more.cases_ai_run — AI case execution on an existing case: the case assistant fills its open steps (signed steps and joins still waiting on their lanes are left alone). Consumes AI credits.cases_ai_fill_step — Let the step assistant fill a step's fields (same as Generate in the editor). Consumes AI credits.cases_delete — Delete a case.cases_subscribers_list — Who is notified about changes to a case.cases_subscribers_add — Subscribe a member (default: you) to a case's notifications.cases_subscribers_remove — Stop a member's (default: your) notifications for a case.cases_reminders_list — A case's reminder rules.cases_reminders_create — Add a reminder rule to a case.cases_reminders_set_paused — Pause or resume a case reminder.cases_reminders_delete — Remove a case reminder.cases_checkpoints_list — Saved versions of a case you can restore.cases_checkpoints_create — Save the case's current state as a restorable checkpoint.cases_checkpoints_restore — Restore a case to a saved checkpoint (from cases_checkpoints_list).cases_attachment_upload — Upload a file into a case's Attachment field (the field's step is looked up). Fails while the step is locked.cases_attachment_download — The file stored in a case's Attachment field (max 15 MB).cases_export_pdf — Render a case as a PDF (all steps by default), returned as an embedded resource.AI drafts, Vynchat, AI completions and search.
ai_complete — Vynflow AI: answer a prompt as structured fields you define (response_fields), optionally over data items. Billed to the workspace.assistant_case_model_draft — Draft a case model (steps, fields, branching) from a description with the AI builder; refine a draft by passing it back as refine.current with an instruction as prompt. Nothing is saved — save with case_models_create_from_draft.assistant_context_draft — Draft a context and its instructions from a description; refine via refine.{context, instructions}. Save with contexts_create (title, content ← description, instructions).assistant_user_table_draft — Draft a user table (columns and types) that fits the workspace's existing tables; refine via refine.table. Save with user_tables_create + user_tables_columns_create.vynchat_ask — Ask Vynchat, the workspace assistant: it answers from your tables, cases and documents and may draft actions (create rows, insights, contexts, ...) that need approval (vynchat_action_approve). Continue a conversation with thread_id.vynchat_threads_list — Your Vynchat conversations.vynchat_thread_get — A Vynchat conversation's messages and drafted actions.vynchat_action_approve — Apply an action Vynchat drafted (writes data). Confirm with the user first.vynchat_action_decline — Decline an action Vynchat drafted.search — Search cases, tables and rows, insights, case models, contexts, calendar, scheduler pools, files, agents and chats. Supports the search bar's operators (e.g. table:Name).Create, plan and activate AI agents; runs and approvals.
vynagents_list — Scheduled/triggered AI agents in the workspace.vynagents_get — An agent with its plan and recent runs.vynagents_run — Start an agent run now (in the background); follow it with vynagents_get / vynagents_run_get. Consumes AI credits.vynagents_set_status — Pause or resume an agent's schedule.vynagents_delete — Delete an agent and its run history.vynagents_run_get — One run with its steps, outputs and errors.vynagents_approvals_list — Agent steps waiting for someone to approve a write.vynagents_step_approve — Approve a parked agent write; the run resumes in the background. Confirm with the user first.vynagents_step_decline — Decline a parked agent write; the run continues without it.vynagents_create — Create an AI agent (as a draft) from a plain-language prompt and a schedule or trigger. Next: vynagents_plan, then vynagents_activate.vynagents_update — Replace an agent's definition (send every field you want kept). Clears any previewed plan; plan again afterwards.vynagents_plan — Have AI turn the agent's prompt into a step plan, check it against the workspace and dry-run it (reads run, writes only report what they would change). Show the plan to the user before activating. Consumes AI credits.vynagents_activate — Put the previewed plan live so the agent runs on its schedule or trigger. Confirm with the user first.Saved insights and data-view widgets.
insights_list — Saved insights (AI analyses over your tables).insights_get — An insight's last results, summary and charts.insights_run — Re-run an insight on current data and return fresh results. Consumes AI credits.insights_create — Create a saved insight from a plain-language question over a table; optionally run it straight away. Consumes AI credits.views_list — Dashboards (data views) you can open.views_get — A data view with its widgets (ids, kinds, settings).views_widget_data — The data a dashboard widget shows (explorer rows, table, insight result, timeline, graph).Notifications, calendar, files and the scheduler.
notifications_list — Your notifications, newest first.notifications_mark_read — Mark notifications read (all when ids is empty).calendar_events_list — Events in a date window (recurring series listed once with their rule).calendar_events_create — Add an event to the workspace calendar.calendar_events_delete — Delete an event (the whole series if it repeats).files_list — Workspace files you can read, newest first.files_read_text — A file's text: PDFs and scans through OCR, text files as-is.files_download — A workspace file's bytes, returned as an embedded resource (max 15 MB).scheduler_pools_list — Work pools with their queue counts and whether you are a member.scheduler_take — Take the oldest open case queued in a pool (members of a 'take' pool, during an active shift where shifts exist).scheduler_assign — Assign (or reassign) a pool's case to a pool member; both are notified.Account, usage, AI profile, billing summary, integrations and add-ons.
account_info — The account these tools act as: user, workspace and roles.workspace_get — The workspace's storage and AI token usage.workspace_ai_profile_get — The organisation profile every AI feature is grounded in (industry, locale, currency, glossary, guidelines). Workspace managers only.workspace_ai_profile_update — Change the organisation's AI profile; fields left out keep their value, an empty string clears one. Workspace managers only.billing_summary — Plan, AI credit balance and recent credit use (read-only). Workspace managers only.integrations_list — The workspace's integrations (secrets are never returned).marketplace_listings_list — Add-ons (case models, tables, contexts, packs) available to install.marketplace_listings_get — One add-on with its published versions and the version installed here.marketplace_installed_list — Add-ons installed in this workspace.marketplace_install — Install an add-on (or update it) into this workspace: it creates its contexts, case models, tables and integrations. Paid add-ons need a purchase in the app. Confirm with the user first.Members, roles and per-resource grants.
iam_members_list — Workspace members with their roles, and the role names that can be assigned.iam_roles_assign — Give a member a role. Confirm with the user first.iam_roles_remove — Take a role away from a member.iam_access_grant — Give a member access to one resource (case, file, row, table, context, insight, view).iam_access_revoke — Remove a member's direct access to a resource.Unauthenticated discovery is supported for:
initialize
tools/listPrompts and resources (prompts/*, resources/*) are open too. This exposes definitions and guides only, never workspace data.
All tools/call requests must include:
Authorization: Bearer sa-p-vynflow-SECRET
X-API-Key: sa-k-vynflow-KEY
X-Domain-ID: DOMAIN_UUIDTo receive MCP responses over SSE, include:
Accept: text/event-streamIf you do not include it, the server returns a normal JSON response.
If the client sends an Origin header, the server validates it against the
MCP_ALLOWED_ORIGINS allowlist (comma-separated). Use * to allow all.
MCP_ALLOWED_ORIGINS=https://app.yourdomain.com,https://yourdomain.com