Supported tools

Koodisi MCP tools fall into four groups: signing in and choosing where to work, building and shipping a workflow, managing the pieces a workflow depends on, and browsing Koodisi's activity catalog for reference.

Sign in and choose where to work

Tool	What it does
sign_in	Signs in with your Koodisi email and password. Reads them from the email / password headers on your connection, so you don't have to type them into chat.
list_orgs	Lists the organizations your account belongs to.
select_org	Selects an organization for the rest of the session.
list_workspaces	Lists workspaces in the selected organization.
select_workspace	Selects a workspace for the rest of the session.
list_apps	Lists apps in the selected workspace.
get_app	Fetches one app's details by id.
create_app	Creates a new app in the selected organization and workspace.
update_app	Renames an app or changes its Git-enabled flag.
delete_app	Permanently deletes an app. Irreversible.
select_app	Selects an app as the build target for the rest of the session.
get_context	Reports the current session: signed-in email, and the selected organization, workspace, and app.

Build and ship a workflow

Tool	What it does
compile_workflow_spec	The main build tool. Takes a complete workflow specification in one call—schemas, trigger, every step, and every edge—and returns a finished draft.
apply_workflow_patch	Edits an existing draft with a sparse patch instead of rebuilding it from scratch.
auto_layout_workflow	Lays out a draft's steps automatically.
create_workflow_in_app	Writes a draft to the selected app as a real workflow. This is the only tool that writes a workflow to the platform.
get_workflow_in_app	Fetches a real workflow from the selected app by id.
update_workflow_in_app	Updates fields on a real workflow in the selected app.
delete_workflow_in_app	Permanently deletes a real workflow from the selected app. Irreversible.
publish_workflow	Publishes a workflow already created in the selected app.
deploy_workflow	Deploys a published workflow version to an environment.

Manage schemas, resources, folders, and variables in your app

These tools act on the app you selected with select_app.

Tool	What it does
create_schema_in_app	Compiles a JSON sample into a schema and creates it in the selected app.
list_schemas_in_app	Lists schemas in the selected app.
get_schema_in_app	Fetches a schema from the selected app by id.
update_schema_in_app	Renames a schema, changes its content, or moves it to a different folder.
delete_schema_in_app	Permanently deletes a schema from the selected app. Irreversible.
create_resource_in_app	Creates a resource—a reusable, pre-configured activity such as a saved database connection—in the selected app.
get_resource_in_app	Fetches a resource from the selected app by id.
update_resource_in_app	Renames a resource, changes its config, or moves it to a different folder.
delete_resource_in_app	Permanently deletes a resource from the selected app. Irreversible.
list_global_variables_in_app	Lists global variable groups in the selected app.
get_global_variable	Fetches a global variable group by id.
create_global_variable	Creates a global variable group in the selected app.
update_global_variable	Updates a global variable group by id.
delete_global_variable	Permanently deletes a global variable group. Irreversible.
create_folder_in_app	Creates a sub-folder inside an existing folder in the selected app.
get_folder	Fetches a folder by id, including its contents.
update_folder	Renames a folder or moves it under a different parent.
delete_folder	Permanently deletes a folder and everything in it. Irreversible.

Browse the activity catalog and reference material

These tools are read-only and don't require selecting an org, workspace, or app.

Tool	What it does
tools_documentation	Returns an overview of the Koodisi MCP tools.
search_activities	Searches Koodisi's activity catalog.
get_activity	Fetches one activity's definition.
get_activities	Fetches several activities' definitions in one call.
list_activity_groups	Lists activity groups and how many activities each contains.
get_activity_usage	Shows real, existing flows that use a given activity, as configuration examples.
get_activity_example	Returns a real config example for an activity, mined from existing flows.
validate_activity_config	Validates a single activity's configuration.
list_skills	Lists Koodisi knowledge topics (expression syntax, mapping, triggers, and more).
get_skill	Fetches one knowledge topic by name.
get_mapping_reference	Returns real, validated mapping expression examples for an activity.
find_template	Searches past flows for architecture and pattern examples.
search_workflows	Searches past flows by name.
get_workflow	Fetches a flow skeleton from the reference corpus by id.
get_schema	Fetches a reusable schema from the reference corpus by id or name.
get_mapping	Reads the mapping fields on a draft activity.
get_wiring_digest	Summarizes what is and isn't connected in a draft workflow.
validate_workflow	Validates a workflow with the same engine Studio uses.

Note: list_platform_references and create_resource also exist on this server, but they read and write the workflow-builder's own open-app session, not the organization/workspace/app you select with select_org/select_workspace/select_app. From an external client, use list_global_variables_in_app and create_resource_in_app instead.

Related

• Connect to Koodisi MCP — how to authenticate and select where these tools act.