Skip to main content
Glama

RightSide MCP Server (@rightsidehost/mcp)

Official Model Context Protocol (MCP) stdio server implementation for RightSide — an agent-native container hosting platform where Claude Code, Codex, and other MCP clients build, deploy, diagnose, manage env vars and opt-in PostgreSQL, configure custom domains, and roll back containerized apps to a verified HTTPS URL.

This repository contains the complete TypeScript source code for the @rightsidehost/mcp server (20 MCP tools built on @modelcontextprotocol/sdk) along with its multi-stage Dockerfile for reproducible local and containerized execution.

Repository Structure

Path

Role

src/index.ts

MCP server implementation using @modelcontextprotocol/sdk (McpServer + zod schemas) registering all 20 RightSide tools

src/bin.ts

Stdio CLI entrypoint connecting the MCP server over StdioServerTransport

src/runtime.ts

Runtime client wiring, credential loading (RIGHTSIDE_TOKEN or stored login), and structured error formatting

src/version.ts

Server version metadata

Dockerfile

Multi-stage non-root (USER 10001:10001) container build running node /app/dist/bin.js

server.json

Official MCP Registry manifest (host.rightside/mcp)

glama.json

Glama MCP directory metadata

Related MCP server: briq

Implemented MCP Tools (20)

All 20 tools are defined and registered directly in src/index.ts:

Deploy & Lifecycle

  • create_project — Create a new RightSide project with optional outbound internet egress (egress: "internet")

  • deploy_project — Package, build, health-check, and promote a container release to https://<slug>.rightside.cloud

  • project_status — Inspect live release state, health, URL, and metadata for a project

  • list_projects — List projects in the authenticated account

  • rollback — Roll back a project to a previous healthy release

  • clear_build_cache — Clear cached container build layers for a project

  • delete_project — Permanently delete a project and its resources

Diagnostics & Verification

  • get_logs — Retrieve bounded, secret-redacted build or runtime logs with structured error codes

  • login_status — Verify authentication state and active account context

  • send_feedback — Submit structured issue reports or feedback

Opt-in PostgreSQL

  • configure_database — Enable or inspect per-project managed PostgreSQL (injecting DATABASE_URL)

  • query_database — Run bounded SQL queries against a project's PostgreSQL database

Secrets & Environment Variables

  • list_env — List configured environment variable names (values redacted)

  • set_env — Set an environment variable for a project

  • import_env — Import variables from a local .env file on disk without echoing secret values into chat

  • unset_env — Remove an environment variable

Custom Domains

  • add_domain — Attach a custom domain and return DNS verification records

  • domain_status — Check DNS propagation and automatic TLS certificate status

  • list_domains — List custom domains attached to a project

  • remove_domain — Detach a custom domain from a project

Build & Run from Source

Requires Node.js >=22.13.

git clone https://github.com/Poligon-Tech/rightside-mcp.git
cd rightside-mcp
npm install
npm run build
node dist/bin.js

The server speaks MCP JSON-RPC over stdio. Listing tools (initialize + tools/list) works immediately with no credentials configured; calling deployment tools requires authentication via RIGHTSIDE_TOKEN or a stored login from rightside login.

Run with Docker

docker build -t rightside-mcp .
docker run -i --rm -e RIGHTSIDE_TOKEN="your-token" rightside-mcp

MCP Client Configuration

Running from a local build

{
  "mcpServers": {
    "rightside": {
      "command": "node",
      "args": ["/path/to/rightside-mcp/dist/bin.js"],
      "env": {
        "RIGHTSIDE_TOKEN": "your-token-optional-if-logged-in"
      }
    }
  }
}

Running via npm (npx)

{
  "mcpServers": {
    "rightside": {
      "command": "npx",
      "args": ["-y", "@rightsidehost/mcp"]
    }
  }
}

Environment Variables

Variable

Required

Description

RIGHTSIDE_TOKEN

No

Account API token. Optional if you authenticated via rightside login.

RIGHTSIDE_OPERATIONS_URL

No

Override the RightSide API origin (defaults to the hosted service).

License

See LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Deploy GitHub repositories or local directories to private URLs directly from an MCP client. Includes tools for managing deployments, reading build logs, and stopping services.
      40 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to deploy, run, expose, inspect, and manage isolated cloud environments, including databases, caches, browsers, GitHub-hosted apps, and arbitrary OCI images, via MCP tools.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI coding assistants to deploy and manage compatible web apps, isolated Postgres databases, and project file storage, while inspecting build logs, runtime errors, and usage through an OAuth-authenticated remote MCP connection.
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to deploy and roll back applications, read build and runtime logs, diagnose broken apps, and run commands inside containers. It also manages environment variables, PostgreSQL databases, domains, cron jobs, marketplace services, and backups on a PaaS platform, with safety annotations so clients can confirm destructive actions.
      58
      MIT