# spin mcp

**Spinbox is experimental: APIs change and data may be lost.** What is built and what proves it is on [Status](https://docs.spinbox.dev/reference/status.md); what Spinbox does not do is on [Limitations](https://docs.spinbox.dev/overview/limitations.md).

> spin mcp: Serve the Model Context Protocol on stdin and stdout, for an agent to work in workspaces.

<!-- Generated by tools/refgen from spin:cmd/cli. Edit the source, not this file. -->

```
Serve the Model Context Protocol on stdin and stdout: the tools an agent drives
workspaces with - make one, run a command and read and write files in it, open a port, and
delete it - each one call to this installation's API with this login's credential.

An agent's key is a delegated one (spin api-key create, or a key with keys:delegate): it reaches
what its key reaches and its workspaces are held to its key's bounds, which the installation
refuses past. Running a command takes workspace:exec. Nothing here knows a model; it is the API.

  claude mcp add spin -- spin mcp

Usage:
  spin mcp [flags]

Flags:
  -h, --help[=true|false]   help for mcp

Global Flags:
      --config string        config file (default is $HOME/.spin/config.yaml)
  -o, --output string        text for a person, or json: one document of what the API answered, and no prose (default "text")
      --profile string       named profile to use; SPIN_PROFILE names it when this flag does not (default "default")
      --traceparent string   the W3C traceparent of the span this command is part of; its own span is sent to the installation unless the profile says telemetry: false
```
