Spaceship MCP Server

An MCP (Model Context Protocol) server for the Spaceship API, providing easy-to-use tools for managing DNS records. Features specialized tools for common record types (A, AAAA, CNAME, MX, SRV, TXT) with explicit parameters, plus generic tools for advanced use cases.

⚠️ Warning: use with care

This MCP server gives AI agents direct control over your DNS records. This can be helpful but also dangerous because:

• Domain takeover risk: Incorrect DNS changes could redirect your domain to malicious sites
• Service disruption: Wrong DNS records can make your websites and services inaccessible
• Permanent consequences: Some DNS changes can have lasting effects on your domain's reputation
• Unintended modifications: AI agents may make DNS changes you didn't expect or want

Recommendations:

• Review AI-suggested DNS changes before confirming them
• Keep backups of your current DNS configuration
• Monitor your domains closely when using this server
• Avoid using it with an AI agent that may also be accessing untrusted content

Status

I use this myself for my own projects.

• Limited testing: As far as I know it is not in widespread use
• No automated tests: There are currently no unit tests or integration tests
• Use at your own risk: Suitable for experimentation but not recommended for critical systems

Contributions, bug reports, and feedback are welcome to help improve the project's stability and reliability.

Features

Core Operations

• List DNS Records: Retrieve all DNS records for a domain
• Delete DNS Records: Remove DNS records from a domain

Specialized Record Creation Tools

Type-specific tools with explicit parameters for easy, error-free DNS management:

• A Records: Create IPv4 address records
• AAAA Records: Create IPv6 address records
• CNAME Records: Create canonical name aliases
• MX Records: Create mail exchange records with priority and exchange parameters
• SRV Records: Create service locator records with priority, weight, port, and target
• TXT Records: Create text records for SPF, DKIM, DMARC, verification, etc.

Generic Tools

• Create/Update DNS Records: Generic tools supporting all DNS record types for advanced use cases

Installation

Prerequisites

• Node.js ≥ 18
• An MCP-compatible client (e.g. Claude Desktop, Cursor, Continue)
• Spaceship API credentials (see Configuration section below)

Install the server

Clone the repository and build:

git clone https://github.com/mattcollins/spaceship-mcp.git
cd spaceship-mcp
npm install
npm run build

Configure your MCP client

Add the server to your MCP client configuration.

Example (Claude Desktop)

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "spaceship": {
      "command": "node",
      "args": ["/absolute/path/to/spaceship-mcp/dist/index.js"],
      "env": {
        "SPACESHIP_API_KEY": "your_api_key",
        "SPACESHIP_API_SECRET": "your_api_secret"
      }
    }
  }
}

Replace /absolute/path/to/spaceship-mcp with the actual path where you cloned the repository.

Restart the client after saving the file.

Verify the installation

After restarting your client, confirm the server is running:

• The server appears in the client's MCP/server list
• No errors appear in the client logs
• Tools exposed by the server (like list_dns_records) are available to the model

To check for startup errors, you can run the server manually:

npm start

Configuration

Environment Variables

Get your API credentials from the [Spaceship API Manager](https://www.spaceshi

... View full README on GitHub