---
title: "tractorbeam mcp"
description: "Connect agents to the Project's MCP Servers."
sidebar:
  label: "mcp"
  order: 20
---

```sh
tractorbeam mcp <subcommand> [flags]
```

## Shared flags

Every subcommand takes these flags.

| Flag | Description |
| --- | --- |
| `--config <string>` | The Project's `tractorbeam.config.ts`. Defaults to the one in the current directory or its nearest ancestor. |
| `--workspace <string>` | Workspace identifier or resource name. Environment variable: `TRACTORBEAM_WORKSPACE`. |
| `--origin <string>` | The Tractorbeam origin to call instead of the default, such as a proxy's. Environment variable: `TRACTORBEAM_ORIGIN`. |
| `--token <string>` | Access token. Defaults to the saved interactive session. Environment variable: `TRACTORBEAM_TOKEN`. |

## `mcp add`

Add the Project's MCP Servers on a Branch to agent harness configuration.

```sh
tractorbeam mcp add [flags]
```

| Flag | Description |
| --- | --- |
| `--branch <string>` | Branch identifier or resource name whose MCP Server routes to add. Defaults to the Branch you last switched to, or main. Environment variable: `TRACTORBEAM_BRANCH`. |
| `--client <claude-code\|cursor\|vscode>` | Agent harness to configure. Defaults to `claude-code`. Repeatable. |
| `--scope <local\|project\|user>` | Claude Code configuration scope: `local` to you in this repository, `project` in its .`mcp.json`, or `user` for all your repositories. Default: `local`. |
| `--codemode` | Connect in code mode, with ?codemode=true. Code mode adds an execute tool running the agent's JavaScript against the MCP Server's tools. |

Examples:

```sh
# Add the MCP Servers to Claude Code for you in this repository
tractorbeam mcp add

# Add them to Cursor and VS Code
tractorbeam mcp add --client cursor --client vscode
```
