---
title: "Coding agents"
description: "Connect Claude Code, Cursor or any MCP client to Spool so your agent can read and update your work as you."
---

> Documentation Index
> Fetch the complete documentation index at: https://spool.team/llms.txt
> Use this file to discover all available pages before exploring further.

# Coding agents

Spool has a built-in MCP server. Connect your coding agent to it and the agent can search your workspace, read items and docs, and create or update work, right from your editor or chat.

## Why connect an agent

Your agent already knows your code. Connected to Spool, it also knows the work around it: the item you're fixing, the decision made in last week's meeting, the doc with the spec. It can then keep Spool up to date as it goes, so you don't have to copy things across by hand.

For example, you can ask your agent to:

- Find `ACM-42`, read its acceptance criteria and start on it.
- Search past meetings and docs for why a decision was made.
- Create a bug for something it found, following your Bug template.
- Comment on an item with what it changed and why.
- Plan items into Sprint 12 or move them to In Review.

## Agents act as you

An agent signs in with your Spool account and works with your role. It sees the teams you see and can only do what your role allows in each one. If you can't delete items in a team, neither can your agent. Its changes show up under your name, marked "via MCP" in the activity history.

When you connect, you choose whether the agent can only read or can also write. You can disconnect it at any time from your account settings, and it stops working straight away.

> **Settings stay in the app**
>
> Agents can read roles, members, teams, statuses and work item types, but they can't change them. Workspace and team settings are only changed in the Spool app.

## Which clients work

Any client that supports remote MCP servers with OAuth sign-in works. Spool shows setup steps for Claude Code, Cursor, VS Code, Codex, and the custom connector settings in Claude and ChatGPT.

One connection covers every workspace you belong to. If you're in more than one, you can pin a workspace to a repo so the agent always uses the right one.

- **Connect an agent** — Add the server, sign in, and manage your connected agents.
- **Tools reference** — Every tool an agent can call, and the permissions each needs.

## Related

- [Connect an agent](https://spool.team/docs/coding-agents/connect/)
- [Tools reference](https://spool.team/docs/coding-agents/tools/)
- [Key concepts](https://spool.team/docs/get-started/key-concepts/)

Source: https://spool.team/docs/coding-agents/overview/index.mdx
