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_projects
List your projects, most recently updated first
status?, limit? (default 50)
get_project
Get a project by ID
project_id
create_project
Create a project (status defaults to backlog)
name, description?, status?
update_project
Update name, description, status, or starred state
project_id, name?, description?, status?, is_starred?
delete_project
Delete a project; rows that reference it are cascade-deleted
project_id
Files & Versions
list_files
List files (id, path, language, updated_at — no content)
project_id, workspace_id?
get_file
Get a file (including content) by ID
file_id
get_file_by_path
Get a file (including content) by project and path; errors if not found
project_id, path
create_file
Create a file. content must be a string (may be empty); language is inferred from the extension if omitted
project_id, path, content, language?
update_file
Update a file's content and/or path
file_id, content?, path?
delete_file
Delete a file by ID
file_id
search_files
Case-insensitive substring search over file contents; up to 10 matching lines per file
project_id, query
search_replace_file
Replace the first exact occurrence of search in a file; errors if not found
project_id, path, search, replace
batch_edit_files
Apply 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_versions
List a file's versions, newest first, including content
file_id, limit? (default 20)
restore_file_version
Overwrite a file's content with a stored version
file_id, version_id
Workspaces
list_workspaces
List workspaces in a project
project_id
create_workspace
Create a workspace
project_id, name, description?, branch_name?
update_workspace
Update name, description, or status (backlog, in_progress, in_review, done, cancelled)
workspace_id, name?, description?, status?
delete_workspace
Delete a workspace
workspace_id
Chat, Streaming & AI Agent
list_chat_messages
List chat messages, oldest first
project_id, limit? (default 100), source?
send_chat_message
Insert a chat message (source defaults to chat)
project_id, role, content, source?
invoke_ai_agent
Run the CloudCode AI agent (tools enabled) on one prompt and return { response, tools_used, project_id }
project_id, prompt, model?, system?
stream_start
Create an empty chat message to stream into; returns message_id
project_id, source? (default claude-code), conversation_id?, role? (default assistant)
stream_chunk
Replace the message content with the full accumulated text (not a delta)
message_id, content
stream_end
Write the final content; returns status "complete"
message_id, content
Deployments, Env Vars, Domains & Terminal
list_deployments
List deployment records, newest first
project_id, limit? (default 20)
create_deployment
Insert a deployment record only — does not build or deploy
project_id, provider? (default vercel), environment? (default production), domain?
list_env_vars
List env vars (id, key, environment, is_secret, updated_at — values are not returned)
project_id
set_env_var
Create or update by key. On update, omitted is_secret / environment reset to false / development
project_id, key, value, is_secret?, environment?
delete_env_var
Delete an environment variable
env_var_id
list_domains
List custom domain records
project_id
add_domain
Insert a custom domain record only — does not configure DNS
project_id, domain, environment? (default production)
remove_domain
Delete a custom domain record
domain_id
list_terminal_sessions
List your terminal sessions for a project
project_id
Memory, Errors & Changelog
list_memories
List project memories (max 100), newest first
project_id, category?, search?
store_memory
Create or update a memory, matched by project + category + key
project_id, category (decision | preference | file_summary | readme | dependency_info), key, value
delete_memory
Delete a memory
memory_id
list_errors
List error history, newest first, including fixes
project_id, limit? (default 20)
record_error
Record an error
project_id, error_message, file?, line?
record_fix
Mark an error fixed and timestamp it
error_id, fix_description
list_changelogs
List session changelog entries, newest first
project_id, session_id?, limit? (default 50)
log_change
Add a session changelog entry
project_id, session_id, action, file_path?, summary?
Activity, Tags & Profile
list_activity
List the project activity log, newest first
project_id, limit? (default 50)
log_activity
Add an activity log entry
project_id, action, details?
list_tags
List project tags
project_id
add_tag
Add a tag
project_id, tag
remove_tag
Remove a tag
tag_id
get_profile
Get your profile
none
update_profile
Update display name, bio, or theme
display_name?, bio?, theme?
Auto-Fix Agent
auto_fix_submit
Submit 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_status
Get the full job record: status, progress timeline, CI checks, verification, post-deploy status, result
job_id
auto_fix_list
List recent jobs, newest first
project_id, limit? (default 25)
auto_fix_cancel
Cancel a queued or running job
job_id
auto_fix_verification
Get verification_status, verification report, and progress_steps
job_id
auto_fix_reverify
Re-run vision regression against the project's latest ready deployment; sets post_deploy_status to live or broken
job_id
auto_fix_revert
Revert 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-tree
JSON array of { path, language } for every file in the project
cloudcode://project/{project_id}/file-tree
…/package-json
Raw package.json content ("{}" if missing)
cloudcode://project/{project_id}/package-json
…/readme
Raw README.md content (text/markdown, empty if missing)
cloudcode://project/{project_id}/readme
…/memories
Up to 100 project memories, most recently updated first
cloudcode://project/{project_id}/memories
…/error-history
The 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_code
Review a file for bugs, style issues, and improvements (embeds the file content)
project_id, file_path
fix_error
Ask the model to read the relevant files and fix the error
project_id, error_message
add_feature
Ask the model to read the code structure, then implement the feature
project_id, description
refactor_file
Refactor a file for structure, readability, and performance (embeds the file content)
project_id, file_path
explain_code
Explain how a file works (embeds the file content)
project_id, file_path