Superjolt MCP Server - AI-Powered JavaScript Deployment Platform

<div align="center">


# Superjolt CLI (Beta)








🤖 AI-Powered Deployment Platform with MCP Support

Official command-line interface for Superjolt - Deploy and manage JavaScript applications with AI assistance.
</div>

> ⚡ Beta Release: We're actively improving Superjolt based on your feedback. Join our Discord to share your experience!
>
> During beta, the CLI will automatically check for critical updates to ensure compatibility with our evolving API.

Table of Contents

- Overview
- Quick Start
- 🤖 AI Integration (MCP)
- Installation
- Commands
- Authentication
- Deployment
- Machine Management
- Service Management
- Custom Domains
- Environment Variables
- Logs
- Other Commands
- Configuration
- CI/CD Integration
- Examples
- Web Dashboard
- Support
- Contributing
- License

Overview

Superjolt CLI is the fastest way to deploy JavaScript applications to the cloud. With integrated AI support through Model Context Protocol (MCP), you can manage your entire infrastructure using natural language with Claude Desktop.

Key Features:
- 🚀 One-command deployment: npx superjolt deploy
- 🤖 AI-powered infrastructure management via MCP
- 🔧 Full service lifecycle management
- 🔐 Secure environment variable handling
- 📊 Real-time logs and monitoring
- 🌐 Automatic SSL and custom domains

Quick Start

From your JavaScript framework project folder, run:

npx superjolt deploy

That's it! The CLI will guide you through authentication and deployment.

🤖 AI Integration (MCP)

Superjolt is one of the first deployment platforms with native Model Context Protocol (MCP) support, allowing you to manage your entire infrastructure through AI assistants like Claude Desktop.

Why MCP?

- Natural Language Control: Manage deployments using conversational commands
- Context-Aware Operations: AI understands your infrastructure state
- Automated Workflows: Let AI handle complex deployment sequences
- Error Resolution: Get intelligent help with deployment issues

Setup MCP

1. Install Superjolt CLI (includes MCP server):

   npm install -g superjolt

   

2. Authenticate with Superjolt:

   superjolt login

   

3. Add to Claude Desktop configuration:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/claude/claude_desktop_config.json

   {
     "mcpServers": {
       "superjolt": {
         "command": "superjolt-mcp",
         "args": []
       }
     }
   }
   

4. Restart Claude Desktop

MCP Capabilities

Once configured, you can use natural language to:

Authentication & CI/CD Setup:
- "Get my authentication token for CI/CD"
- "Show me how to set up GitHub Actions"
- "Check if I'm authenticated"

Infrastructure Management:
- "Create a new production machine"
- "List all my running services"
- "Show me services that are stopped"
- "Delete all test machines"

Deployment Operations:
- "Restart my API service"
- "Stop the staging environment"
- "Show logs for the web service"

Configuration:
- "Set DATABASE_URL for my backend"
- "List all environment variables"
- "Update API keys for production"

Custom Domains:
- "Add app.example.com to my web service"
- "List all custom domains"
- "Check validation status for my domain"
- "Remove old.example.com"

Available MCP Tools

<details>
<summary>View all MCP tools</summary>

Authentication

- check_auth - Check if authenticated with Superjolt - get_current_user - Get current user information - get_token - Get authentication token for CI/CD use

Machine Management

- list_machines - List all machines - create_machine - Create a new machine - delete_machine - Delete a machine - rename_machine - Rename a machine - set_default_machine - Set the default machine for deployments

Service Management

- list_services - List services (optionally filtered by machine) - start_service - Start a service - stop_service - Stop a service - restart_service - Restart a service - delete_service - Delete a service - rename_service - Rename a service

Environment Variables

- list_env_vars - List all environment variables for a service - set_env_vars - Set one or more environment variables - get_env_var - Get a specific environment variable - delete_env_var - Delete an environment variable - push_env_file - Push a .env file to a service

Custom Domains

- add_custom_domain - Add a custom domain to a service - list_custom_domains - List custom domains for a service or all services - remove_custom_domain - Remove a custom domain - get_custom_domain_status - Get the status of a custom domain

Logs

- get_logs - Get logs for a service

</details>

MCP Requirements & Troubleshooting

- Node.js 16 or later is required (The MCP server uses modern JavaScript features)
- If you see Unexpected token '??=' errors, Claude Desktop is using an old Node.js version

Solutions:
1. Set your default Node version and restart Claude Desktop:

   nvm alias default 16  # or higher

   # Completely quit and restart Claude Desktop

   

2. Or use explicit paths in your Claude Desktop config:

   {

     "mcpServers": {

       "superjolt": {

         "command": "/path/to/node16+/bin/node",

         "args": ["/path/to/node16+/bin/superjolt-mcp"]

       }

     }

   }

   

Installation

You can use Superjolt CLI in several ways:

Using npx (no installation required)

npx superjolt deploy

Global Installation

Install the Superjolt CLI globally using npm:

npm install -g superjolt

Or using yarn:

yarn global add superjolt

Commands

Authentication

- superjolt login - Authenticate with your Superjolt account
- superjolt logout - Log out from your account
- superjolt me - Display current user information
- superjolt token - Display your authentication token for CI/CD use
- --show - Show the full token (for exporting)

Deployment

- superjolt deploy [options] - Deploy your application to Superjolt
- -p, --path <path> - Path to the application directory (defaults to current directory)
- -s, --service <serviceId> - Deploy to existing service (optional)
- -m, --machine <machineId> - Machine ID to deploy to
- -n, --name <name> - Service name (defaults to package.json name for new services)
- -v, --verbose - Show detailed build output and logs

Machine Management

…