MCP reference

The tools Gaitro's MCP server gives your agent, from opening a project and claiming symbols to running checks and shipping.

Start the server with gaitro mcp (Connect your agent). It works across every project in the company you logged in to: open one first, and the other tools work in it.

Projects

Tool What it does
gaitro_projects The projects you can work on with this login.
gaitro_open_project Make a project the one you're working in; cloned to ~/gaitro/<company>/<project> the first time.
gaitro_requests Changes people asked for in the app that no agent has taken yet.

Drafts

Tool What it does
gaitro_overlap Is anyone else working on what this folder changes? Opens and claims nothing.
gaitro_intent Open a draft for one request, with its plan, checks and claims, before editing.
gaitro_push Open a draft from work already done, or save its next checkpoint.
gaitro_symbols Search the code index for symbols to claim, and see who holds them.
gaitro_claim Add or extend claims; if another draft holds one, wait, ask or narrow.
gaitro_release Give claims back.
gaitro_sync Save a checkpoint: safety checks locally, then the affected checks.
gaitro_status Checks, safety findings, blockers and the next step.
gaitro_wait Return when the draft's checks have finished.
gaitro_ready Mark the draft done without shipping it.
gaitro_ship Publish, once the person has said to ship.
gaitro_replay Re-apply the draft onto the latest version.
gaitro_choice Hand a conflict to a person to decide.
gaitro_safety_ok Answer a safety finding with a reason (logged).

Checks

Tool What it does
gaitro_check_add Add a plain-language check, with its test if it's written.
gaitro_check_compile Link a check to the command that runs its test.
gaitro_check_edit Reword or re-point a check this draft added.
gaitro_check_remove Drop a check this draft added.
gaitro_check_logs A check's latest full output.
gaitro_check_env What checks run in: OS, Node, tools, network, env vars, timeouts.
gaitro_check_setup The command that runs once before each run's checks.

Knowledge

Tool What it does
gaitro_knowledge_search Known answers for a package, versions and error.
gaitro_knowledge_show One answer in full.
gaitro_knowledge_for_claim Known answers for the packages behind a claim, to plan around them.
gaitro_knowledge_ask Ask a question with no failing check yet.

Secrets

Tool What it does
gaitro_secret_names The names of the project's secrets; values are never returned.
gaitro_secret_set Store a secret's value.

This page as markdown, for your agent: /docs/mcp.md. Every page at once: /llms-full.txt.