Agent Capabilities

Capability commands update the tools and runtime requirements Spinup keeps with an agent. Capabilities cover skills, MCP servers, tools, plugins, CLIs, and runtime requirements. See Capabilities for the concept.

The CLI can mark a capability as declared or disabled. Runtime fulfillment is recorded later when Spinup projects or validates the capability inside the agent environment.

Supported capability kinds today:

• skill
• mcp_server
• tool
• plugin
• cli
• runtime_requirement

List capabilities

spinup agents capabilities list agent_01hxyz...

Use --slug when you already have the agent slug:

spinup agents capabilities list --slug support-agent

Add a capability

spinup agents capabilities add agent_01hxyz... \
  --kind cli \
  --name ffmpeg \
  --source system

Add a capability that references existing secret binding IDs:

spinup agents capabilities add --slug support-agent \
  --kind mcp_server \
  --name firecrawl \
  --source firecrawl-mcp \
  --secret-binding-ids secret_binding_01hxyz...

Secret values are never passed through this command. The IDs only declare which existing secret bindings the capability requires.

Update a capability

spinup agents capabilities update agent_01hxyz... capability_01hxyz... \
  --status disabled

Use --status declared to re-enable a disabled capability.

You can update bounded control-plane fields such as name, source, status, version, and secret binding IDs:

spinup agents capabilities update --slug support-agent capability_01hxyz... \
  --name ffmpeg \
  --source system \
  --version 7

Remove a capability

spinup agents capabilities remove agent_01hxyz... capability_01hxyz...

JSON output

spinup agents capabilities list agent_01hxyz... --json
spinup agents capabilities add agent_01hxyz... --kind cli --name ffmpeg --source system --json
spinup agents capabilities update agent_01hxyz... capability_01hxyz... --status disabled --json
spinup agents capabilities remove agent_01hxyz... capability_01hxyz... --json

The JSON response includes the saved state version, the current capability list, and any missing secret requirements. Spinup applies and validates capabilities asynchronously when the agent environment is reconciled or used for a run.