Skip to content
Back to search

rightside-mcp

Official Model Context Protocol (MCP) server for RightSide — deploy, debug, manage env vars, opt-in PostgreSQL, custom domains, and roll back containerized apps from Claude Code, Codex, and MCP clients.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/poligon-tech--rightside-mcp/badge.svg)](/listings/poligon-tech--rightside-mcp)

HTML

<a href="/listings/poligon-tech--rightside-mcp"><img src="/api/listings/poligon-tech--rightside-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 122 lines
  1. # RightSide MCP Server (`@rightsidehost/mcp`)
  2. Official Model Context Protocol (MCP) stdio server implementation for **[RightSide](https://rightside.host/)** — 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.
  3. 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.
  4. ## Repository Structure
  5. | Path | Role |
  6. | --- | --- |
  7. | [`src/index.ts`](src/index.ts) | MCP server implementation using `@modelcontextprotocol/sdk` (`McpServer` + `zod` schemas) registering all 20 RightSide tools |
  8. | [`src/bin.ts`](src/bin.ts) | Stdio CLI entrypoint connecting the MCP server over `StdioServerTransport` |
  9. | [`src/runtime.ts`](src/runtime.ts) | Runtime client wiring, credential loading (`RIGHTSIDE_TOKEN` or stored login), and structured error formatting |
  10. | [`src/version.ts`](src/version.ts) | Server version metadata |
  11. | [`Dockerfile`](Dockerfile) | Multi-stage non-root (`USER 10001:10001`) container build running `node /app/dist/bin.js` |
  12. | [`server.json`](server.json) | Official MCP Registry manifest (`host.rightside/mcp`) |
  13. | [`glama.json`](glama.json) | Glama MCP directory metadata |
  14. ## Implemented MCP Tools (20)
  15. All 20 tools are defined and registered directly in [`src/index.ts`](src/index.ts):
  16. ### Deploy & Lifecycle
  17. - `create_project` — Create a new RightSide project with optional outbound internet egress (`egress: "internet"`)
  18. - `deploy_project` — Package, build, health-check, and promote a container release to `https://<slug>.rightside.cloud`
  19. - `project_status` — Inspect live release state, health, URL, and metadata for a project
  20. - `list_projects` — List projects in the authenticated account
  21. - `rollback` — Roll back a project to a previous healthy release
  22. - `clear_build_cache` — Clear cached container build layers for a project
  23. - `delete_project` — Permanently delete a project and its resources
  24. ### Diagnostics & Verification
  25. - `get_logs` — Retrieve bounded, secret-redacted build or runtime logs with structured error codes
  26. - `login_status` — Verify authentication state and active account context
  27. - `send_feedback` — Submit structured issue reports or feedback
  28. ### Opt-in PostgreSQL
  29. - `configure_database` — Enable or inspect per-project managed PostgreSQL (injecting `DATABASE_URL`)
  30. - `query_database` — Run bounded SQL queries against a project's PostgreSQL database
  31. ### Secrets & Environment Variables
  32. - `list_env` — List configured environment variable names (values redacted)
  33. - `set_env` — Set an environment variable for a project
  34. - `import_env` — Import variables from a local `.env` file on disk without echoing secret values into chat
  35. - `unset_env` — Remove an environment variable
  36. ### Custom Domains
  37. - `add_domain` — Attach a custom domain and return DNS verification records
  38. - `domain_status` — Check DNS propagation and automatic TLS certificate status
  39. - `list_domains` — List custom domains attached to a project
  40. - `remove_domain` — Detach a custom domain from a project
  41. ## Build & Run from Source
  42. Requires Node.js `>=22.13`.
  43. ```bash
  44. git clone https://github.com/Poligon-Tech/rightside-mcp.git
  45. cd rightside-mcp
  46. npm install
  47. npm run build
  48. node dist/bin.js
  49. ```
  50. 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`.
  51. ## Run with Docker
  52. ```bash
  53. docker build -t rightside-mcp .
  54. docker run -i --rm -e RIGHTSIDE_TOKEN="your-token" rightside-mcp
  55. ```
  56. ## MCP Client Configuration
  57. ### Running from a local build
  58. ```json
  59. {
  60. "mcpServers": {
  61. "rightside": {
  62. "command": "node",
  63. "args": ["/path/to/rightside-mcp/dist/bin.js"],
  64. "env": {
  65. "RIGHTSIDE_TOKEN": "your-token-optional-if-logged-in"
  66. }
  67. }
  68. }
  69. }
  70. ```
  71. ### Running via npm (`npx`)
  72. ```json
  73. {
  74. "mcpServers": {
  75. "rightside": {
  76. "command": "npx",
  77. "args": ["-y", "@rightsidehost/mcp"]
  78. }
  79. }
  80. }
  81. ```
  82. ### Environment Variables
  83. | Variable | Required | Description |
  84. | --- | --- | --- |
  85. | `RIGHTSIDE_TOKEN` | No | Account API token. Optional if you authenticated via `rightside login`. |
  86. | `RIGHTSIDE_OPERATIONS_URL` | No | Override the RightSide API origin (defaults to the hosted service). |
  87. ## Related
  88. - Website: https://rightside.host
  89. - Documentation: https://rightside.host/docs/
  90. - Official MCP Registry: `host.rightside/mcp`
  91. - npm package: https://www.npmjs.com/package/@rightsidehost/mcp
  92. - Agent skills & Claude Code plugin marketplace: https://github.com/Poligon-Tech/rightside-skills
  93. ## License
  94. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.