# MCP reference

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

Source: https://gaitro.com/docs/mcp

Start the server with `gaitro mcp` ([Connect your agent](/docs/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. |