Tools
What the MCP server can call, and what it refuses.
Call tools/list for the names. Do not invent a tool. A missing or non-Bearer Authorization header returns unauthenticated and does not call the API.
A read times out at 30 seconds. A deploy or other change returns when the API accepts it. It does not wait until the operation succeeds. Call operations_inspect for the status. Stop when that status is failed.
What you can call
| Group | Tools |
|---|---|
| Identity | whoami |
| Workspace | workspaces_list, workspaces_create, workspaces_inspect |
| Project | projects_list, projects_create, environments_list, environments_create, providers_list |
| Applications | apps_list, apps_inspect, apps_document, apps_deploy, apps_build, apps_logs, apps_events, apps_events_pods, apps_env_get, apps_env_set, apps_secret_list, apps_secret_set, apps_secret_unset, apps_releases_list, apps_rollback, apps_route_set, apps_route_show |
| Data | db_list, db_postgres_create, db_info, db_credentials, db_link, volumes_create, jobs_create, jobs_schedule, templates_list, templates_install |
| Recipes | recipe_schema, recipe_example, recipe_validate |
| Access | tokens_list, tokens_create, operations_inspect, operations_cancel, github_token_set, github_token_show |
| Older names | list_projects, list_applications, create_application, create_deployment, get_deployment_status, get_logs, list_operations |
apps_env_set replaces the whole variable map. db_credentials reveals a connection once. github_token_set stores a GitHub token for a private repository. An API token cannot store that GitHub token, and it cannot create a workspace. The personal workspace is private.
Confirmation
A delete or revoke returns validation and does not call the API when the confirmation is missing or empty.
| Tool | Argument | Must equal |
|---|---|---|
apps_delete | confirm_name | application name |
db_delete | confirm_name | service name |
volumes_delete | confirm_name | volume name |
tokens_revoke | confirmation | display prefix |
apps_route_delete | confirm_host | that host |
Not tools
Signup, logout, a password, and an invite stay on the CLI. environments_delete is not a tool. dflow clusters:register is not a tool. There is no Kubernetes, shell, or exec tool.
How is this guide?
Last updated on