Supported tools

Koodisi MCP tools are grouped below by what they do. Tools that create, change or delete something act on the real platform immediately; tools marked Irreversible can't be undone, so a well-behaved client asks you before calling them.

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, including its folders and contents.
create_app	Creates a new app in the selected organization and workspace.
update_app	Renames an app or changes its Git-enabled flag.
set_app_active	Activates or deactivates an app, like the Studio's Active toggle. Deactivating is reversible and deletes nothing; use it to free a slot when the workspace's active-app limit is reached.
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 workflow or draft with a sparse patch instead of rebuilding it.
auto_layout_workflow	Re-arranges a workflow's steps with the same layout as the Studio's Autolayout button.
compile_schema	Creates a standalone schema from a JSON sample. A workflow's own schemas belong in compile_workflow_spec.
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	Changes fields on a real workflow in the selected app; send only what changes.
delete_workflow_in_app	Permanently deletes a workflow from the selected app. Irreversible.
publish_workflow	Publishes a workflow in the selected app as its next version, with every Resource and app schema it references.
deploy_workflow	Deploys a published version to an environment. Leave out the version to publish and deploy in one call. Subflows (workflows started by Start) can't be deployed on their own.

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 (or takes a JSON 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. Irreversible.
create_resource_in_app	Creates a resource, a reusable pre-configured activity such as a saved 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. 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.

Build custom activities

See Build a custom activity for the end-to-end flow.

Tool	What it does
create_activity_group	Creates a new activity group together with its activities in one call.
create_custom_activity	Creates one custom activity, for example a REST Client-based activity for a vendor API.
bulk_create_custom_activities	Creates several custom activities and their default input and output schemas in one call.
generate_activity_metadata_from_openapi	Generates a name, tags, description and icon for OpenAPI operations.
generate_mappable_fields_from_openapi	Generates the configuration fields for an activity's path, query and header parameters from an OpenAPI operation.
validate_custom_activity	Runs every check create and update run, without writing anything.
get_custom_activity	Fetches an activity's full definition: form, configuration and schema.
update_custom_activity	Replaces a custom activity with the full definition you send.
patch_custom_activity	Changes a few fields of a custom activity without sending the whole definition.
save_activity_default_schema	Attaches the default input and output schema a workflow's mapper reads.
list_custom_activities	Lists the live activity index.
list_activity_group_index	Lists the live activity group index.
test_custom_activity	Runs an activity against sample input and returns the real output or error, like the editor's Test button.
validate_resource	Checks a resource configuration before you save it.
delete_custom_activity	Deletes a custom activity. Irreversible.
delete_activity_group	Deletes an activity group and every activity in it. A dry run unless you confirm, and default groups are refused. Irreversible.

Connect activities to OAuth APIs

Tool	What it does
list_idps	Lists the OAuth identity providers registered for your organization.
create_idp	Registers an OAuth identity provider, for example a vendor's OAuth app.
list_resource_templates_for_provider	Lists the resource templates tied to an identity provider.
create_resource_template	Creates a resource template: the scopes and credentials a resource connects with.
update_resource_template	Updates a resource template.
initiate_oauth_connection	Starts the OAuth sign-in for a saved resource and returns a link for you to open in a browser.
check_oauth_credential_status	Reports whether a resource has a completed, usable connection.
get_oauth_credential_status_detail	Connection status with non-secret details: flow type, whether tokens are stored, expiry and scopes. Never returns token values.
disconnect_oauth_credential	Removes a resource's stored connection.
test_activity_with_live_credential	Tests an OAuth-backed activity with the resource's real connection, without deploying anything.

Build AI agents

These tools work with Agent Studio.

Tool	What it does
list_agents	Lists every agent in the selected workspace.
get_agent	Fetches an agent with its current draft and active published version.
create_agent	Creates an agent.
update_agent_metadata	Renames an agent or changes its description, visibility or tags.
update_agent_config	Saves the agent's draft configuration: instructions, connection, tools, guardrails, knowledge, memory and more.
list_agent_versions	Lists every version of an agent: draft, pending, published and rejected.
publish_agent	Publishes the current draft as the agent's new active version.
test_agent	Sends a real chat message to the agent's published version, like Agent Studio's Chats tab.
get_agent_card	Fetches the agent's A2A card, which other agents use to delegate to it.
list_agent_memory_workspaces	Lists which deployment workspaces hold memory for the agent.
inspect_agent_memory	Reads the agent's stored memory entries in one deployment workspace.
delete_agent	Permanently deletes an agent and all its versions. Irreversible.

Manage agent capabilities

Tool	What it does
list_registry_items	Lists registry items of one type, such as connections, tools or guardrails.
get_registry_item	Fetches one registry item.
create_connection	Creates a model connection: provider, model and credentials.
create_tool	Creates a REST tool with one or more named actions.
create_guardrail	Creates a guardrail.
create_mcp_source	Registers an MCP server an agent can call tools through.
create_prompt	Creates a reusable prompt fragment.
create_skill	Creates a skill: instructions an agent can load when relevant.
create_a2a_registry	Registers another agent, by its A2A card URL, for delegation.
create_memory_provider	Creates a memory provider connection.
create_knowledge_source	Creates a knowledge source to upload files into.
register_activity_as_tool	Registers an existing platform activity as an agent tool, like the Studio's Add Activity as Tool wizard.
update_activity_tool	Updates an activity tool.
update_registry_item	Updates any other registry item.
update_registry_item_visibility	Changes an item's visibility: agent, organization or global.
delete_registry_item	Permanently deletes a registry item. Irreversible.
discover_mcp_oauth	Discovers an MCP server's OAuth endpoints from its URL.
register_mcp_oauth_client	Registers an OAuth client for an MCP server.
connect_mcp_oauth	Starts an agent's OAuth connection to an MCP server or activity tool, and returns a link for you to open.
get_mcp_oauth_status	Reports whether an agent has completed that OAuth connection.
disconnect_mcp_oauth	Revokes an agent's OAuth connection.

Knowledge files

Tool	What it does
upload_knowledge_files	Uploads files into a knowledge source and reindexes it.
list_knowledge_files	Lists a knowledge source's files.
download_knowledge_file	Downloads one file.
delete_knowledge_file / delete_knowledge_files	Deletes one file, or several in one reindex.
reindex_knowledge_files	Rebuilds the index without re-uploading, for example after a failure.
get_knowledge_source_index_status	Reports the index status (EMPTY, READY or FAILED) and chunk count.

Evaluate agents

Tool	What it does
create_eval_dataset / list_eval_datasets / update_eval_dataset / delete_eval_dataset	Manage an agent's eval datasets.
create_eval_case / list_eval_cases / update_eval_case / delete_eval_case	Manage the test cases in a dataset: which tool the agent should choose, or what its final answer should contain.
create_eval_run / list_eval_runs	Start and list eval runs for one agent version.
record_eval_result / list_eval_results	Record and list each case's result in a run.

Global review

Tool	What it does
list_pending_global_review	Lists items awaiting a decision on promotion to global.
submit_for_global_review	Submits an organization item for promotion to global.
approve_global_review / reject_global_review	Approves or rejects a pending request.
retract_global_review	Withdraws your own pending request.

Review and diagnose

Tool	What it does
validate_workflow	Validates a workflow with the same engine as the Studio's Validate Flow, plus completeness checks.
get_wiring_digest	Summarizes what is and isn't connected in a workflow, step by step.
review_activity_config	Finds problems in a step's configuration, such as an unset connection.
explain_expression	Explains one mapping expression: what it reads, which functions it calls, and known pitfalls.
review_mapping_document	Diagnoses a whole mapping and proposes corrections.
diagnose_mapping	A deeper mapping diagnosis for output that's still wrong after review.
adapt_mapping	Updates a mapping after its source schemas changed.
merge_workflows	Merges two edits of the same workflow by what changed.
answer_question	Answers a support or design question from the workflow and evidence, not from memory.
assess_report	Lists which facts a problem report still needs for a diagnosis.
search_support_history	Finds earlier support cases resembling a problem.
advise_build / design_flow	Suggest how to build what you describe, from how existing workflows do it.
file_report / add_knowledge_item	Add a problem report or a new item to the knowledge base.

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 / get_activities	Fetches one or several activities' definitions.
list_activity_groups	Lists activity groups and how many activities each contains.
get_activity_example	Returns real configuration examples for an activity, mined from existing flows.
validate_activity_config	Validates a single activity's configuration.
list_skills / get_skill	List and fetch Koodisi knowledge topics: expression syntax, mapping, triggers and more.
get_mapping_reference	Returns real, validated mapping expression examples.
find_template / search_workflows	Search past flows from other apps for patterns. They don't search your own app.
get_workflow	Fetches a flow from the reference corpus by id.
get_schema	Fetches a reusable schema from the reference corpus.
get_mapping	Reads the mapping fields on a draft step.

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 and app you select with select_org, select_workspace and 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.
• Build a custom activity: custom activities and OAuth connections end to end.