Spaceship MCP

What Spaceship MCP MCP server does

Spaceship MCP MCP server connects an MCP-compatible client to the Spaceship API. Its tools cover domain discovery and lifecycle operations, DNS management, and reusable contact profiles. The repository describes 48 tools across eight categories, including support for marketplace and SellerHub capabilities.

Domain tools can list account domains, retrieve detailed information, check availability for up to 20 names, change nameservers, toggle auto-renewal, toggle transfer lock, and retrieve transfer authorization codes. Lifecycle operations include registration, renewal, restoration, and transfer. Registration, renewal, restoration, and transfer are financial operations and run asynchronously, so the server also provides tools for checking operation and transfer status.

DNS tools support listing records with pagination, upserting records, deleting records by name and type, and creating specific record types. The dedicated creation tools cover A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, NS, PTR, SRV, SVCB, TLSA, and TXT records. Contact management is represented by a tool that creates or updates a reusable contact profile.

How it works

The server runs locally and communicates with the MCP host over stdio. Each request is translated into a Spaceship API operation, with Zod schemas used for input and output validation according to the README. Pagination is available for domain and DNS record listings. Operations that Spaceship handles asynchronously can be polled with an operation ID rather than treated as immediately complete.

The project also documents MCP resources for passive context loading, prompts for guided workflows, and polling-based resource subscriptions. These features may help a client provide domain, DNS, contact, or SellerHub context without an explicit tool call, depending on the host client’s support for those MCP features.

Setup and configuration

Install the npm package with Node.js 20 or newer:

npx -y spaceship-mcp

Set these environment variables in the MCP client configuration:

• SPACESHIP_API_KEY: Spaceship API key.
• SPACESHIP_API_SECRET: Spaceship API secret.

The repository provides configuration examples for Claude Desktop, Cursor, Windsurf, Cline, VS Code, Codex CLI, Gemini CLI, Docker, and other MCP-compatible hosts. For a stdio configuration, use npx with -y spaceship-mcp as the arguments and pass both credentials through the environment. Do not place credentials directly in prompts or tool arguments.

Tools and capabilities

Spaceship MCP MCP server is suited to agent-driven domain administration, such as checking whether names are available, reviewing DNS configuration, updating nameservers, or preparing a domain transfer. It can also perform account changes that have financial or operational consequences, including registration, renewal, restoration, and transfer. Those actions should be exposed only to agents with appropriate authorization and review controls.

The server’s DNS coverage is broader than basic A and CNAME management: it includes mail, service discovery, certificate authorization, TLS association, reverse DNS, and service-binding record types. The README also lists DNS alignment analysis, WHOIS privacy and contact management, SellerHub support, five MCP resources, and nine MCP prompts among the project’s documented features.