Spaceship MCP

A community-built Model Context Protocol (MCP) server for the Spaceship API. Manage domains, DNS records, contacts, marketplace listings, and more — all through natural language via any MCP-compatible AI client.
> **Note:** This is an unofficial, community-maintained project and is not affiliated with or endorsed by Spaceship.
Add To Your Editor
CLI one-liners — the fastest way to get started. Pick your tool:
Claude Code
Codex CLI (OpenAI)
Gemini CLI (Google)
Set environment variables SPACESHIP_API_KEY and SPACESHIP_API_SECRET separately via ~/.gemini/settings.json.
VS Code (Copilot)
Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) > MCP: Add Server > select **Command (stdio)**.
Or add to .vscode/mcp.json in your project directory:
Cursor
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
Supported Clients
This MCP server works with any client that supports the Model Context Protocol, including:
| Client | Easiest install |
|---|---|
| Claude Code | One-liner: claude mcp add |
| Codex CLI (OpenAI) | One-liner: codex mcp add |
| Gemini CLI (Google) | One-liner: gemini mcp add |
| VS Code (Copilot) | Command Palette: MCP: Add Server |
| Claude Desktop | JSON config file |
| Cursor | JSON config file |
| Windsurf | JSON config file |
| Cline | UI settings |
| Zed | JSON settings file |
Claude Desktop, Cowork & other GUI clients (expand)
Claude Desktop / Cowork
Cowork runs inside Claude Desktop and uses the same connected MCP servers and permissions. Configure once in Claude Desktop, then the server is available in Cowork.
Add the following to your Claude Desktop config file:
| Platform | Config file |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
Windsurf / Cline / Zed
**Windsurf** — add to ~/.codeium/windsurf/mcp_config.json:
**Cline** — open Settings > MCP Servers > Edit, then add the same mcpServers block shown above.
**Zed** — add to your Zed settings (~/.zed/settings.json on macOS, ~/.config/zed/settings.json on Linux):
Docker
Generic MCP Server Config
Use this as the baseline in any host:
- **Command:** npx
- **Args:** ["-y", "spaceship-mcp"]
- **Required env vars:** SPACESHIP_API_KEY, SPACESHIP_API_SECRET
- **Optional env vars:** SPACESHIP_CACHE_TTL, SPACESHIP_MAX_RETRIES, SPACESHIP_TOOLSETS, SPACESHIP_DYNAMIC_TOOLS (see Configuration)
Host key mapping:
| Host | Top-level key | Notes |
|---|---|---|
| VS Code | servers | Add "type": "stdio" on the server object |
| Claude Desktop / Cursor / Windsurf / Cline | mcpServers | Same command/args/env block |
| Zed | context_servers | Same command/args/env block |
| Codex CLI (TOML) | mcp_servers | Uses TOML, shown below |
Codex CLI (TOML config alternative)
If you prefer editing ~/.codex/config.toml directly:
Other MCP Clients
For any MCP-compatible client, use this server configuration:
- **Command:** npx
- **Args:** ["-y", "spaceship-mcp"]
- **Environment variables:** SPACESHIP_API_KEY and SPACESHIP_API_SECRET
Claude Ecosystem Notes
Claude currently has multiple MCP-related concepts that are easy to mix up:
- **Local MCP servers (Claude Desktop):** defined in claude_desktop_config.json and started on your machine (docs).
- **Cowork:** reuses the MCP servers connected in Claude Desktop (docs).
- **Connectors:** remote MCP integrations managed in Claude (docs).
- **Cowork plugins:** Claude-specific workflow packaging (instructions + tools/data integrations) (docs). Useful in Claude, but not portable as a generic MCP server config for other agent clients.
Verified against vendor docs on **2026-03-05**.
Terminology
What is portable across hosts:
- MCP server runtime settings (command, args, env)
- Transport model (stdio command server)
- Tool names and tool schemas exposed by this server
What is host/vendor-specific (not portable as-is):
- Host config key names (servers, mcpServers, context_servers, mcp_servers)
- Host UX/workflows for adding servers (CLI commands, UI menus, settings paths)
- Anthropic-specific concepts such as Claude Desktop local MCP servers, Claude Connectors via remote MCP, and Claude Code plugins used in Cowork workflows
Features
- **48 tools** across 8 categories covering the full Spaceship API