Spaceship DNS MCP Server

A Model Context Protocol (MCP) server for managing DNS records on Spaceship.com domains.

Features

• List domains — View all domains in your Spaceship account
• Get domain info — View registration details for a specific domain
• List DNS records — View all DNS records for a domain
• Add DNS records — Create A, AAAA, CNAME, MX, TXT, NS records
• Delete DNS records — Remove DNS records by type and name

Installation

pip install mcp

Usage

Option 1: HTTP/SSE Server (recommended for remote access)

export SPACESHIP_API_KEY="your_api_key"
export SPACESHIP_API_SECRET="your_api_secret"
python3 spaceship-dns-mcp.py

Starts on http://0.0.0.0:8021 with SSE endpoint at /sse.

Option 2: Stdio (for local use with MCP clients)

export SPACESHIP_API_KEY="your_api_key"
export SPACESHIP_API_SECRET="your_api_secret"
python3 spaceship-dns-mcp.py stdio

Authentication

Obtain your API key and secret from the Spaceship API Manager.

The API uses:

• Header: X-API-Key — your API key
• Header: X-API-Secret — your API secret

API Reference

The server wraps the Spaceship REST API.

MCP Tool	HTTP Method	Spaceship Endpoint
list_domains()	GET	/api/v1/domains
get_domain_info(domain)	GET	/api/v1/domains/{domain}
list_dns_records(domain)	GET	/api/v1/domains/{domain}/dns/records
add_dns_record(domain, type, name, value, ttl)	POST	/api/v1/domains/{domain}/dns/records
delete_dns_records(domain, type, name)	DELETE	/api/v1/domains/{domain}/dns/records/{type}/{name}

License

MIT