Documentation Available MCP Tools
Available MCP Tools
The MCP server exposes 57 tools organized by domain, plus 5 resources and 5 prompts. Call tools/list for the exact input schemas. Parameters marked ? are optional; all IDs are UUID strings. Every tool returns its result as JSON text.
Projects
list_projectsList your projects, most recently updated first
status?, limit? (default 50)
get_projectGet a project by ID
project_id
create_projectCreate a project (status defaults to backlog)
name, description?, status?
update_projectUpdate name, description, status, or starred state
project_id, name?, description?, status?, is_starred?
delete_projectDelete a project; rows that reference it are cascade-deleted
project_id
Files & Versions
list_filesList files (id, path, language, updated_at — no content)
project_id, workspace_id?
get_fileGet a file (including content) by ID
file_id
get_file_by_pathGet a file (including content) by project and path; errors if not found
project_id, path
create_fileCreate a file. content must be a string (may be empty); language is inferred from the extension if omitted
project_id, path, content, language?
update_fileUpdate a file's content and/or path
file_id, content?, path?
delete_fileDelete a file by ID
file_id
search_filesCase-insensitive substring search over file contents; up to 10 matching lines per file
project_id, query
search_replace_fileReplace the first exact occurrence of search in a file; errors if not found
project_id, path, search, replace
batch_edit_filesApply several write / search_replace / delete edits in order. For search_replace, content is the replacement text. Rollback on failure is best-effort (see note below)
project_id, edits[] { path, operation, content?, search? }
list_file_versionsList a file's versions, newest first, including content
file_id, limit? (default 20)
restore_file_versionOverwrite a file's content with a stored version
file_id, version_id
Workspaces
list_workspacesList workspaces in a project
project_id
create_workspaceCreate a workspace
project_id, name, description?, branch_name?
update_workspaceUpdate name, description, or status (backlog, in_progress, in_review, done, cancelled)
workspace_id, name?, description?, status?
delete_workspaceDelete a workspace
workspace_id
Chat, Streaming & AI Agent
list_chat_messagesList chat messages, oldest first
project_id, limit? (default 100), source?
send_chat_messageInsert a chat message (source defaults to chat)
project_id, role, content, source?
invoke_ai_agentRun the CloudCode AI agent (tools enabled) on one prompt and return { response, tools_used, project_id }
project_id, prompt, model?, system?
stream_startCreate an empty chat message to stream into; returns message_id
project_id, source? (default claude-code), conversation_id?, role? (default assistant)
stream_chunkReplace the message content with the full accumulated text (not a delta)
message_id, content
stream_endWrite the final content; returns status "complete"
message_id, content
Deployments, Env Vars, Domains & Terminal
list_deploymentsList deployment records, newest first
project_id, limit? (default 20)
create_deploymentInsert a deployment record only — does not build or deploy
project_id, provider? (default vercel), environment? (default production), domain?
list_env_varsList env vars (id, key, environment, is_secret, updated_at — values are not returned)
project_id
set_env_varCreate or update by key. On update, omitted is_secret / environment reset to false / development
project_id, key, value, is_secret?, environment?
delete_env_varDelete an environment variable
env_var_id
list_domainsList custom domain records
project_id
add_domainInsert a custom domain record only — does not configure DNS
project_id, domain, environment? (default production)
remove_domainDelete a custom domain record
domain_id
list_terminal_sessionsList your terminal sessions for a project
project_id
Memory, Errors & Changelog
list_memoriesList project memories (max 100), newest first
project_id, category?, search?
store_memoryCreate or update a memory, matched by project + category + key
project_id, category (decision | preference | file_summary | readme | dependency_info), key, value
delete_memoryDelete a memory
memory_id
list_errorsList error history, newest first, including fixes
project_id, limit? (default 20)
record_errorRecord an error
project_id, error_message, file?, line?
record_fixMark an error fixed and timestamp it
error_id, fix_description
list_changelogsList session changelog entries, newest first
project_id, session_id?, limit? (default 50)
log_changeAdd a session changelog entry
project_id, session_id, action, file_path?, summary?
Activity, Tags & Profile
list_activityList the project activity log, newest first
project_id, limit? (default 50)
log_activityAdd an activity log entry
project_id, action, details?
list_tagsList project tags
project_id
add_tagAdd a tag
project_id, tag
remove_tagRemove a tag
tag_id
get_profileGet your profile
none
update_profileUpdate display name, bio, or theme
display_name?, bio?, theme?
Auto-Fix Agent
auto_fix_submitSubmit a fix job (prompt or error report). Generates edits, verifies, pushes to GitHub as a PR or commit, optionally auto-merges, polls CI, re-fixes real CI failures up to max_fix_retries (0–3, default 1), checks the live deploy and auto-reverts broken deploys. Needs a GitHub repo (github_owner/github_repo or the project's linked repo).
project_id, prompt | error_message, file?, line?, stack_trace?, target_branch? (default main), delivery? (pr | commit, default pr), auto_merge? (default false), max_fix_retries?, github_owner?, github_repo?
auto_fix_statusGet the full job record: status, progress timeline, CI checks, verification, post-deploy status, result
job_id
auto_fix_listList recent jobs, newest first
project_id, limit? (default 25)
auto_fix_cancelCancel a queued or running job
job_id
auto_fix_verificationGet verification_status, verification report, and progress_steps
job_id
auto_fix_reverifyRe-run vision regression against the project's latest ready deployment; sets post_deploy_status to live or broken
job_id
auto_fix_revertRevert the job's merge commit on target_branch; sets post_deploy_status to reverted
job_id
Warning
batch_edit_files is not fully atomic. If an edit fails, only files that already existed and were targeted by a write or delete edit have their previous content restored. Earlier search_replace edits, newly created files, and deletions are not undone.Note
File paths passed to
create_file, update_file, search_replace_file, and batch_edit_files must be relative and may not contain .. or backslashes. When a file's content changes, the previous content is saved to its version history automatically.Resources
resources/list returns these URIs with a literal {project_id} placeholder. Replace it with a project UUID before calling resources/read.
…/file-treeJSON array of { path, language } for every file in the project
cloudcode://project/{project_id}/file-tree
…/package-jsonRaw package.json content ("{}" if missing)
cloudcode://project/{project_id}/package-json
…/readmeRaw README.md content (text/markdown, empty if missing)
cloudcode://project/{project_id}/readme
…/memoriesUp to 100 project memories, most recently updated first
cloudcode://project/{project_id}/memories
…/error-historyThe 20 most recent error-history entries
cloudcode://project/{project_id}/error-history
Prompts
prompts/get returns a single user message. All arguments are required.
review_codeReview a file for bugs, style issues, and improvements (embeds the file content)
project_id, file_path
fix_errorAsk the model to read the relevant files and fix the error
project_id, error_message
add_featureAsk the model to read the code structure, then implement the feature
project_id, description
refactor_fileRefactor a file for structure, readability, and performance (embeds the file content)
project_id, file_path
explain_codeExplain how a file works (embeds the file content)
project_id, file_path