tractorbeam mcp
Connect agents to the Project's MCP Servers.
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.
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:
# 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