# Spaceship MCP [Health: Active]

**Category:** ☁️ Cloud Platforms  
**Repository:** https://github.com/bartwaardenburg/spaceship-mcp  
**GitHub Stars:** 13  
**npm Downloads (last month):** 388  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/spaceship-mcp

## Description
Manage domains, DNS records, contacts, marketplace listings, and more via the Spaceship API

## Tools
Capabilities this server exposes over MCP:

- **list_dns_records** — List all DNS records for a domain with pagination
- **save_dns_records** — Save (upsert) DNS records — replaces records with the same name and type
- **delete_dns_records** — Delete DNS records by name and type
- **create_a_record** — Create an A record (IPv4 address)
- **create_aaaa_record** — Create an AAAA record (IPv6 address)
- **create_alias_record** — Create an ALIAS record (CNAME flattening at zone apex)
- **create_caa_record** — Create a CAA record (Certificate Authority Authorization)
- **create_cname_record** — Create a CNAME record (canonical name)
- **create_https_record** — Create an HTTPS record (SVCB-compatible)
- **create_mx_record** — Create an MX record (mail exchange)
- **create_ns_record** — Create an NS record (nameserver delegation)
- **create_ptr_record** — Create a PTR record (reverse DNS)
- **create_srv_record** — Create an SRV record (service locator)
- **create_svcb_record** — Create an SVCB record (general service binding)
- **create_tlsa_record** — Create a TLSA record (DANE/TLS certificate association)
- **create_txt_record** — Create a TXT record (text data)
- **list_domains** — List all domains in the account with pagination
- **get_domain** — Get detailed domain information
- **check_domain_availability** — Check availability for up to 20 domains at once
- **update_nameservers** — Update nameservers for a domain
- **set_auto_renew** — Toggle auto-renewal for a domain
- **set_transfer_lock** — Toggle transfer lock for a domain
- **get_auth_code** — Get the transfer auth/EPP code
- **register_domain** — Register a new domain (financial operation, async)
- **renew_domain** — Renew a domain registration (financial operation, async)
- **restore_domain** — Restore a domain from redemption grace period (financial operation, async)
- **transfer_domain** — Transfer a domain to Spaceship (financial operation, async)
- **get_transfer_status** — Check the status of a domain transfer
- **get_async_operation** — Poll the status of an async operation by its operation ID
- **save_contact** — Create or update a reusable contact profile
- **get_contact** — Retrieve a saved contact by ID
- **save_contact_attributes** — Save TLD-specific contact attributes (e.g. tax IDs)
- **get_contact_attributes** — Retrieve all stored contact attributes
- **update_domain_contacts** — Update domain contacts (registrant, admin, tech, billing)
- **set_privacy_level** — Set WHOIS privacy level (high or public)
- **set_email_protection** — Toggle contact form display in WHOIS
- **list_personal_nameservers** — List vanity/glue nameservers for a domain
- **get_personal_nameserver** — Get details of a personal nameserver by hostname
- **update_personal_nameserver** — Create or update a personal nameserver (glue record)
- **delete_personal_nameserver** — Delete a personal nameserver
- **list_sellerhub_domains** — List domains for sale on the marketplace
- **create_sellerhub_domain** — List a domain for sale with pricing
- **get_sellerhub_domain** — Get listing details
- **update_sellerhub_domain** — Update listing display name, description, and pricing
- **delete_sellerhub_domain** — Remove a listing from the marketplace
- **create_checkout_link** — Generate a buy-now checkout link for a listing
- **get_verification_records** — Get DNS verification records for a listing
- **check_dns_alignment** — Compare expected vs actual DNS records to detect missing or unexpected entries

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "spaceship-mcp": {
    "command": "npx",
    "args": ["-y","spaceship-mcp"],
    "env": {
      "SPACESHIP_API_KEY": "",
      "SPACESHIP_API_SECRET": ""
    }
  }
}
```

**Requires environment variables:** `SPACESHIP_API_KEY`, `SPACESHIP_API_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/spaceship-mcp/readme_