> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiml-code-it.automat-it.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Code-it MCP tools

> Every tool the Code-it MCP server serves, by access group.

Source of truth: the tool catalog in `apps/api/src/slices/mcp-access/mcp-catalog.ts`. Server version at the time of writing: 0.9.0. A token is granted by group. **Writes** change state and need a token that allows mutating tools.

## Projects and branches (`projects`)

| Tool | Writes | What it does |
| - | - | - |
| `list_code_it_projects` | no | List the projects an agent can be created in |
| `list_code_it_branches` | no | List the branches a project's repositories have, for choosing a base |

## Repositories, write (`repositories`)

| Tool | Writes | What it does |
| - | - | - |
| `create_code_it_branch` | yes | Create a branch on GitHub. Acts with the platform's own GitHub credential, so grant this group with care |

## Project configuration, read (`project-config-read`)

| Tool | Writes | What it does |
| - | - | - |
| `get_code_it_project_config` | no | Read repos, MCP servers (secrets masked) and Kiro skills |
| `list_code_it_skills` | no | Built-in and approved registry skills available to a project |
| `get_code_it_triggers` | no | Read scheduled-starts triggers |
| `get_code_it_work_profiles` | no | Read work profiles and layered rules |

## Project configuration, write (`project-config-write`)

| Tool | Writes | What it does |
| - | - | - |
| `update_code_it_project_repos` | yes | Edit a project's repositories. Admin only |
| `update_code_it_project_mcp_servers` | yes | Edit MCP servers wired into the Kiro agent. Admin only |
| `set_code_it_project_skill` | yes | Enable or disable a registry skill. Lead or admin |
| `set_code_it_triggers` | yes | Replace scheduled-starts triggers. Admin |
| `set_code_it_work_profiles` | yes | Replace work profiles and layered rules. Admin |

## Agents, read (`environments-read`)

| Tool | Writes | What it does |
| - | - | - |
| `list_agents` | no | Every agent with status, owner and ticket, within the token's owner scope |
| `check_environment_status` | no | Setup state of one ticket's agent |
| `get_task_status` | no | The agent's ticket, branch and pull requests with review state |
| `runner_status` | no | Whether a developer's runner is connected, its version, OS and Kiro CLI |

## Agents, operate (`environments-write`)

| Tool | Writes | What it does |
| - | - | - |
| `create_agent` | yes | Start an agent for a ticket or branch on the developer's laptop |
| `update_agent` | yes | Check out a branch into a running agent's workspace |
| `stop_agent` | yes | Stop the agent. Workspace and work survive |
| `start_agent` | yes | Resume a stopped agent |
| `terminate_agent` | yes | End the agent and release its workspace. Irreversible |
| `ensure_agent_running` | yes | Check whether a ticket's agent exists and is running |

## Agent cost, read (`agent-cost-read`)

| Tool | Writes | What it does |
| - | - | - |
| `get_code_it_agent_cost` | no | Kiro credits and USD for one agent, priced against the owner's monthly allowance, with a daily series and run-out projection |

## Lessons (`lessons`)

| Tool | Writes | What it does |
| - | - | - |
| `list_code_it_lessons` | no | An agent's lessons. Dismissed ones are hidden by default |
| `dismiss_code_it_lesson` | yes | Mark a lesson not relevant. Owner, lead or admin |
| `restore_code_it_lesson` | yes | Restore a dismissed lesson |
| `keep_code_it_correction` | yes | Keep the one pending correction as a lesson now, or leave it out |

## Agent session (`agent`)

| Tool | Writes | What it does |
| - | - | - |
| `list_agent_sessions` | no | The chats on an agent, and which one carries the ticket brief |
| `get_agent_session` | no | The conversation, live status and any pending question |
| `read_agent_conversation` | no | More of one chat's transcript |
| `answer_agent_question` | yes | Answer the pending question |
| `send_agent_prompt` | yes | Type a prompt. Attributed to the token's owner |
| `interrupt_agent` | yes | Send Escape to end the agent's current turn |

## Scope

Tool grants decide which tools exist for a token. A separate **owner scope** decides which agents those tools can see and act on. A token scoped to one developer sees only that developer's agents. Out-of-scope agents look the same as missing ones.

Powers consent has no MCP tool by design. It is per developer and managed in the web app.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.