Spaceship AI CLI

Install the Spaceship AI MCP server into every AI coding tool on your machine with one command.

Quick start

npx spaceshipai@latest init

Opens your browser to sign in and authorize the CLI — no API key copying required. Detects and installs to Claude Code, Cursor, VS Code, and Windsurf — whichever you have installed.

Install to Cursor

Available MCP tools

Once installed, these tools are available in your AI IDE:

Tool	Description
list_projects	List all projects in your org
list_agents	List agents, optionally filtered by project
get_agent	Get full details of a single agent
create_agent	Create an agent with auto-generated system prompt
update_agent	Update name, prompt, or tools
delete_agent	Permanently delete an agent
run_agent	Start an async run; returns execution_id
get_run_status	Poll run status until completed or errored
get_run_logs	Fetch full event log for a completed run
list_executions	List recent runs with status and duration
test_agent	Quick sync test with 15s timeout
list_tools	List tools available to attach to agents
list_orchestrations	List orchestrations, optionally filtered by project
get_orchestration	Get full details of an orchestration including its members
run_orchestration	Start an async orchestration run; returns execution_id
test_orchestration	Quick sync test of an orchestration with 15s timeout

Manual configuration

If you prefer to configure manually, add this to your IDE's MCP config file:

{
  "spaceship": {
    "command": "uvx",
    "args": ["spaceship-mcp"],
    "env": {
      "SPACESHIP_API_KEY": "sk_live_..."
    }
  }
}

IDE	Config file
Claude Code	~/.claude/mcp.json or run claude mcp add
Cursor	~/.cursor/mcp.json
VS Code	.vscode/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json

License

MIT