@selfhost.dev/mcp-server 0.3.0 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # SelfHost MCP Server
 
-A full-featured [Model Context Protocol](https://modelcontextprotocol.io/) server that brings [SelfHost's](https://selfhost.dev) database management capabilities directly into AI coding assistants. Provision, monitor, scale, and manage production database infrastructure — all through natural language, without leaving your editor.
+A full-featured [Model Context Protocol](https://modelcontextprotocol.io/) server that brings the [SelfHost](https://selfhost.dev) cloud platform directly into AI coding assistants. Provision, monitor, scale, and manage production database infrastructure **and** deploy apps from GitHub - projects, builds, env vars, custom domains, and more - all through natural language, without leaving your editor.
 
 Works with **Claude Code**, **Cursor**, **Windsurf**, **Cline**, and any MCP-compatible client.
 
@@ -57,7 +57,7 @@ That's it. The server handles authentication, token refresh, and everything else
 
 ### First Run
 
-On first use, the MCP server opens your browser to sign in via SelfHost's console. After you authorize, credentials are saved locally (`~/.selfhost/credentials.json`) and auto-refreshed — you won't need to sign in again.
+On first use, the MCP server opens your browser to sign in via SelfHost's console. After you authorize, credentials are saved locally (`~/.selfhost/credentials.json`) and auto-refreshed - you won't need to sign in again.
 
 ```
 You: "Show me my databases"
@@ -89,16 +89,22 @@ Claude: Authenticates → fetches your orgs → selects org → lists instances
 | *"Upgrade my org to the Pro plan"* | Confirms billing state, creates or changes the subscription |
 | *"Spin up a Postgres instance on Hetzner in Helsinki"* | Confirms provider, walks through Hetzner location + server type, provisions on Hetzner Cloud |
 | *"What cloud providers can I use?"* | Lists AWS and Hetzner with their capabilities so you can pick |
+| *"Create a project and deploy my GitHub repo into it"* | Provisions a project, waits for it to be ready, detects the build config, and deploys the repo |
+| *"Deploy the main branch of my-org/api"* | Creates a deployment, triggers the build, and streams build logs until it's live |
+| *"Set DATABASE_URL on my app and redeploy"* | Updates the env var (without wiping the others) and rolls out the change |
+| *"Add a Postgres database to my project"* | Provisions a Postgres database inside the project with the credentials you choose |
+| *"Point app.example.com at my deployment"* | Attaches the custom domain and returns the exact DNS records to add, then verifies them |
+| *"Roll back my app to the last working deploy"* | Re-deploys the commit from the previous successful run |
 
 ### Safety Built In
 
-Destructive operations (delete, stop, reboot) require explicit confirmation. The server will always ask before proceeding — you'll never accidentally delete a production database.
+Destructive operations (delete, stop, reboot) require explicit confirmation. The server will always ask before proceeding - you'll never accidentally delete a production database.
 
 ---
 
 ## Features
 
-### 111 tools across 14 modules
+### 151 tools across 22 modules
 
 Every tool maps to a real API endpoint. No mock data, no shortcuts.
 
@@ -117,7 +123,7 @@ Automatic browser-based sign-in with Firebase. Tokens refresh transparently.
 | `reauthenticate` | Sign out and sign in again (switch accounts) |
 
 #### Organizations & Team Management
-Multi-tenant — everything is scoped to your org.
+Multi-tenant - everything is scoped to your org.
 
 | Tool | Description |
 |------|-------------|
@@ -147,7 +153,7 @@ Bring your own AWS account (BYOC) or use SelfHost's managed infrastructure.
 | `get_aws_account_info` | AWS account ID and free tier status |
 
 #### Networking
-VPCs, subnets, and security groups. Optional — auto-created during provisioning if not specified.
+VPCs, subnets, and security groups. Optional - auto-created during provisioning if not specified.
 
 | Tool | Description |
 |------|-------------|
@@ -237,29 +243,29 @@ PostgreSQL-only. Reduces connection overhead for high-concurrency workloads. Cli
 | `disable_pgbouncer` | Drain pool and disable (with confirmation) |
 
 #### Database Users
-DBMS-level credentials — distinct from the SelfHost platform login. Use for apps and people that need their own DB user.
+DBMS-level credentials - distinct from the SelfHost platform login. Use for apps and people that need their own DB user.
 
 | Tool | Description |
 |------|-------------|
 | `list_database_users` | List users with role, status, target DB, expiry metadata |
 | `create_database_user` | Create user with role (read_only / read_write / admin) and optional connection limit + password expiry |
 | `update_database_user` | Change role, connection limit, or password expiry |
-| `delete_database_user` | Soft-delete user (with confirmation) — drops active connections |
-| `rotate_database_user_password` | Rotate password (with confirmation) — new value shown once |
+| `delete_database_user` | Soft-delete user (with confirmation) - drops active connections |
+| `rotate_database_user_password` | Rotate password (with confirmation) - new value shown once |
 
 #### Scaling
 Manual one-off resize plus auto-scaling policies (reactive metric-based, scheduled cron, and auto start/stop).
 
 | Tool | Description |
 |------|-------------|
-| `scale_instance` | Manual resize — change instance type, volume type, size, IOPS, throughput |
+| `scale_instance` | Manual resize - change instance type, volume type, size, IOPS, throughput |
 | `list_scaling_policies` | List policies, optionally filtered to one instance |
-| `create_scaling_policy` | Create policy — reactive metric breach, scheduled cron, or auto start/stop schedule |
+| `create_scaling_policy` | Create policy - reactive metric breach, scheduled cron, or auto start/stop schedule |
 | `update_scaling_policy` | Modify thresholds, schedule, or action details |
 | `delete_scaling_policy` | Remove a policy (with confirmation) |
 
 #### Point-in-Time Recovery (PITR)
-PostgreSQL-only, Pro+. Continuous WAL archiving to S3 + restore to any second within the retention window. Restore creates a brand-new instance — the source is untouched.
+PostgreSQL-only, Pro+. Continuous WAL archiving to S3 + restore to any second within the retention window. Restore creates a brand-new instance - the source is untouched.
 
 | Tool | Description |
 |------|-------------|
@@ -279,18 +285,18 @@ Subscription lifecycle and payment-method linking. All endpoints scoped to the a
 | `get_subscription` | Get current subscription (404 = no subscription, on Free) |
 | `create_subscription` | Start a paid subscription (plan goes `pending` → `active` via Razorpay webhook) |
 | `change_subscription` | Upgrade or downgrade plan (downgrades scheduled at cycle end) |
-| `cancel_subscription` | Cancel — keeps access until cycle end (with confirmation) |
-| `link_billing_payment_method` | Initiate Razorpay link — returns short URL to open in browser |
+| `cancel_subscription` | Cancel - keeps access until cycle end (with confirmation) |
+| `link_billing_payment_method` | Initiate Razorpay link - returns short URL to open in browser |
 | `update_billing_contact` | Update billing phone / tax ID / country / state for invoices |
 
 #### Hetzner Cloud (Postgres-only)
-Provisioning on Hetzner Cloud as an alternative to AWS. Currently provision / get / status / delete only — no start / stop / reboot / update / scaling / PITR / pooling yet. Call `list_cloud_providers` at the start of any create-database intent to surface both options to the user.
+Provisioning on Hetzner Cloud as an alternative to AWS. Currently provision / get / status / delete only - no start / stop / reboot / update / scaling / PITR / pooling yet. Call `list_cloud_providers` at the start of any create-database intent to surface both options to the user.
 
 | Tool | Description |
 |------|-------------|
 | `list_cloud_providers` | List available cloud providers (AWS, Hetzner) with capabilities + the create tool to use for each |
 | `list_hetzner_locations` | Hetzner datacenter locations (fsn1, nbg1, hel1, ash, sin) with country + continent |
-| `list_hetzner_server_types` | Hetzner server types (cpx11–cpx51) with vCPU / RAM / local disk |
+| `list_hetzner_server_types` | Hetzner server types (cpx11-cpx51) with vCPU / RAM / local disk |
 | `create_hetzner_instance` | Provision a Postgres instance on Hetzner Cloud (region, server type, storage size, HA toggle, CIDR allowlist) |
 | `get_hetzner_instance` | Fetch a Hetzner instance's full details by PID |
 | `get_hetzner_instance_status` | Poll provisioning progress (per-step status: network → firewall → ssh_key → server → volume → load_balancer → ansible → finalize) |
@@ -298,6 +304,86 @@ Provisioning on Hetzner Cloud as an alternative to AWS. Currently provision / ge
 
 ---
 
+### PaaS - Projects (app containers)
+A **project** is a per-app container: a provisioned server + Coolify install + wildcard DNS that deployments, databases, and services attach to. Creation is async (~2-5 min) - poll `get_project` until status is `active` before deploying into it.
+
+| Tool | Description |
+|------|-------------|
+| `list_projects` | List projects in the org (pid, name, status, public_ip, domain) |
+| `get_project` | Get one project; poll this for provisioning progress (active / failed) |
+| `create_project` | Create a project and start async provisioning (returns status `pending`) |
+| `update_project` | Rename / re-describe a project |
+| `delete_project` | Tear down the server and everything in the project (with confirmation; blocked while provisioning or with running deployments) |
+| `get_project_metrics` | Time-series server + database + deployment metrics from the monitoring agent (start_date/end_date) |
+
+### PaaS - Deployments (GitHub apps)
+A **deployment** is an app built from a GitHub repo, living inside an `active` project. Build/run history is returned inline on the deployment.
+
+| Tool | Description |
+|------|-------------|
+| `list_deployments` | List apps in the org, each with inline build runs (newest 50) |
+| `get_deployment` | Get one app + runs; poll this for deploy/run progress |
+| `create_deployment` | Deploy a GitHub repo into a project (repo_url, branch, build_pack, port, env_vars, …) |
+| `update_deployment` | Pause/resume, toggle auto-deploy, set ignore_paths / max preview deployments |
+| `update_deployment_build_config` | Change build_pack / base_directory / port / dockerfile / env_vars |
+| `delete_deployment` | Remove the app and its Coolify resources (with confirmation) |
+| `trigger_deploy` | Manually deploy the current branch (new run) |
+| `get_deployment_logs` | Current application/container logs |
+| `get_deployment_health` | Reachability of the deploy URL + attached domains |
+| `get_run_logs` | Full build + container logs for one run (poll until terminal) |
+| `redeploy_run` | Re-run a build from the same commit |
+| `rollback_run` | Re-deploy the commit from a prior successful run |
+
+### PaaS - Custom Domains
+| Tool | Description |
+|------|-------------|
+| `add_deployment_domain` | Attach a custom domain to a deployment (returns DNS records to add) |
+| `sync_deployment_domains` | Set the full domain list for a deployment (set primary / remove several) |
+| `remove_deployment_domain` | Remove one domain from a deployment |
+| `verify_custom_domain` | Check DNS (TXT + CNAME) and advance verification → live HTTPS |
+| `list_custom_domains` | List the org's custom-domain verification states |
+
+### PaaS - Environment Variables
+| Tool | Description |
+|------|-------------|
+| `list_env_vars` | List a deployment's env vars (values returned in cleartext) |
+| `set_env_vars` | **Replace** the entire env-var set (omitted keys are deleted) |
+| `merge_env_vars` | Add/update env vars without deleting others (safe upsert) |
+| `delete_env_var` | Remove one variable by key |
+
+### PaaS - GitHub
+| Tool | Description |
+|------|-------------|
+| `list_github_installations` | Connected GitHub App installations + their accessible repos |
+| `list_repo_branches` | Branches for a repo via an installation |
+| `detect_repo_config` | Auto-detect build_pack / port / monorepo dirs / env-var hints for a repo |
+| `get_github_connect_url` | Get a browser URL to connect GitHub (interactive; then re-list installations) |
+
+### PaaS - Project Databases
+Postgres/Redis/MySQL/MongoDB provisioned inside a project (distinct from AWS/Hetzner managed instances).
+
+| Tool | Description |
+|------|-------------|
+| `list_project_databases` | List databases attached to a project |
+| `create_project_database` | Provision a Postgres/Redis/MySQL/MongoDB in a project (type-specific credentials) |
+| `delete_project_database` | Delete a project database (exact name match + confirmation) |
+
+### PaaS - Project Services (templates)
+| Tool | Description |
+|------|-------------|
+| `list_project_services` | List service-template instances (e.g. Supabase) in a project |
+| `create_project_service` | Deploy a service template (currently `supabase`) into a project |
+| `delete_project_service` | Delete a project service (exact name match + confirmation) |
+
+### PaaS - Deployment Notifications
+| Tool | Description |
+|------|-------------|
+| `list_deployment_notification_bindings` | Channels notified on a deployment's deploy outcomes |
+| `bind_deployment_notification_channel` | Notify an org channel (nchan_…) on deploy success/failure |
+| `unbind_deployment_notification_channel` | Stop notifying a channel for a deployment |
+
+---
+
 ## Common Workflows
 
 ### Switch AWS Account (BYOC vs Platform-Managed)
@@ -370,12 +456,12 @@ Reference data lookups (regions, instance types, storage types) are unlimited.
 | `API_URL` | `https://api.selfhost.dev` | SelfHost API endpoint |
 | `CONSOLE_URL` | `https://console.selfhost.dev` | SelfHost Console URL (for browser auth) |
 | `TIER` | Auto-detected | Override rate limit tier (`FREE`, `STARTER`, `PRO`, `ENTERPRISE`, `ADMIN`) |
-| `FIREBASE_API_KEY` | — | Skip browser auth (CI/headless) |
-| `FIREBASE_REFRESH_TOKEN` | — | Skip browser auth (CI/headless) |
+| `FIREBASE_API_KEY` | - | Skip browser auth (CI/headless) |
+| `FIREBASE_REFRESH_TOKEN` | - | Skip browser auth (CI/headless) |
 
 ### Local Development
 
-Both `API_URL` and `CONSOLE_URL` are optional overrides — they default to the production endpoints when not set.
+Both `API_URL` and `CONSOLE_URL` are optional overrides - they default to the production endpoints when not set.
 
 **1. Local Rails API + Local Console**
 
@@ -452,7 +538,7 @@ Set `FIREBASE_API_KEY` and `FIREBASE_REFRESH_TOKEN` environment variables to ski
 ## Security
 
 - **Credentials stored locally** at `~/.selfhost/credentials.json` with `chmod 0600` (owner-only read/write)
-- **JWT auto-refresh** — tokens refresh 5 minutes before expiry, refresh tokens are rotated
-- **Sensitive fields stripped** — passwords, AWS keys, tokens, and secrets are redacted from API responses
-- **Destructive operations gated** — delete, stop, and reboot require explicit `confirm: true`
-- **No console.log** — all logging goes to stderr to avoid corrupting the MCP JSON-RPC stream on stdout
+- **JWT auto-refresh** - tokens refresh 5 minutes before expiry, refresh tokens are rotated
+- **Sensitive fields stripped** - passwords, AWS keys, tokens, and secrets are redacted from API responses
+- **Destructive operations gated** - delete, stop, and reboot require explicit `confirm: true`
+- **No console.log** - all logging goes to stderr to avoid corrupting the MCP JSON-RPC stream on stdout

package/dist/index.js

@@ -18,6 +18,14 @@ import { registerScalingTools } from "./tools/scaling.js";
 import { registerPitrTools } from "./tools/pitr.js";
 import { registerBillingTools } from "./tools/billing.js";
 import { registerHetznerTools } from "./tools/hetzner.js";
+import { registerProjectTools } from "./tools/projects.js";
+import { registerDeploymentTools } from "./tools/deployments.js";
+import { registerDeploymentDomainTools } from "./tools/deployment-domains.js";
+import { registerEnvVarTools } from "./tools/env-vars.js";
+import { registerGithubTools } from "./tools/github.js";
+import { registerProjectDatabaseTools } from "./tools/project-databases.js";
+import { registerProjectServiceTools } from "./tools/project-services.js";
+import { registerDeploymentNotificationTools } from "./tools/deployment-notifications.js";
 const server = new McpServer({
     name: "selfhost",
     version: "0.1.0",
@@ -42,14 +50,31 @@ registerAlertTools(server);
 registerPgBouncerTools(server);
 // Module 10: Database users (DBMS-level credentials)
 registerDatabaseUserTools(server);
-// Module 11: Scaling — manual + auto-scaling policies + auto start/stop
+// Module 11: Scaling - manual + auto-scaling policies + auto start/stop
 registerScalingTools(server);
 // Module 12: Point-in-Time Recovery (Postgres, Pro+)
 registerPitrTools(server);
-// Module 13: Billing — subscriptions + payment-method linking
+// Module 13: Billing - subscriptions + payment-method linking
 registerBillingTools(server);
-// Module 14: Hetzner Cloud — Postgres-only provision/get/status/delete + provider discovery
+// Module 14: Hetzner Cloud - Postgres-only provision/get/status/delete + provider discovery
 registerHetznerTools(server);
+// ─── PaaS / Apps surface (/api/v1/platform/...) ──────────────────────────────
+// Module 15: Projects - CoolifyProject app-container lifecycle + metrics
+registerProjectTools(server);
+// Module 16: Deployments - GitHub-repo apps, build runs, deploy/redeploy/rollback, logs, health
+registerDeploymentTools(server);
+// Module 17: Custom domains - deployment-scoped add/sync/remove + org DNS verification
+registerDeploymentDomainTools(server);
+// Module 18: Environment variables - list / set (replace) / merge / delete
+registerEnvVarTools(server);
+// Module 19: GitHub - installations (+repos), branches, repo config detection, connect URL
+registerGithubTools(server);
+// Module 20: Project databases - Postgres/Redis/MySQL/MongoDB inside a project
+registerProjectDatabaseTools(server);
+// Module 21: Project services - service templates (Supabase) inside a project
+registerProjectServiceTools(server);
+// Module 22: Deployment notifications - bind/unbind org channels to deploy outcomes
+registerDeploymentNotificationTools(server);
 // Server utility tools
 server.tool("reauthenticate", "Clear stored credentials and sign in again (use to switch accounts or fix auth issues)", {}, async () => {
     try {
@@ -78,7 +103,7 @@ async function main() {
     if (!(await hasCredentials()) && !(await wasAuthPrompted())) {
         markAuthPrompted().catch(() => { });
         getValidToken().catch(() => {
-            // Timeout or error — user can retry via any tool call
+            // Timeout or error - user can retry via any tool call
         });
     }
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/deployment-domains.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDeploymentDomainTools(server: McpServer): void;

package/dist/tools/deployment-domains.js

@@ -0,0 +1,128 @@
+import { z } from "zod";
+import { apiRequest } from "../client.js";
+import { session } from "../session.js";
+/**
+ * Custom domains for deployments. Two layers:
+ * - Deployment-scoped DeploymentDomain (rides on the deployment payload)
+ * - Org-scoped CustomDomainVerification (DNS ownership state, shared across deployments)
+ *
+ * Endpoints:
+ * - PATCH  /api/v1/platform/github_repo_deployments/:pid/domains       full-replace the domain set
+ * - POST   /api/v1/platform/github_repo_deployments/:pid/domains       append one domain
+ * - DELETE /api/v1/platform/github_repo_deployments/:pid/domains/:domain   remove one
+ * - GET    /api/v1/platform/custom_domains                             list org domain verifications
+ * - POST   /api/v1/platform/custom_domains/:domain/verify             check DNS records live
+ *
+ * Adding a domain auto-creates the org verification record and returns the DNS
+ * records (a TXT for ownership + a CNAME for routing) the user must add. A
+ * domain only goes live (and gets a cert) once `verify_custom_domain` confirms
+ * BOTH records.
+ */
+const DEPLOYMENTS_BASE = "/api/v1/platform/github_repo_deployments";
+const CUSTOM_DOMAINS_BASE = "/api/v1/platform/custom_domains";
+const NO_ORG = "No active organization. Call `list_organizations` then `select_organization` first.";
+function hasOrg() {
+    return session.getActiveOrgId() !== null;
+}
+function normalizeDomain(domain) {
+    return domain.trim().toLowerCase().replace(/^https?:\/\//, "").replace(/\/.*$/, "");
+}
+export function registerDeploymentDomainTools(server) {
+    server.tool("sync_deployment_domains", "Set the FULL list of custom domains on a deployment (replaces any existing set - domains not included are removed). Use this to set/change the primary domain or remove several at once. For just adding one domain, prefer `add_deployment_domain`. Each domain that's new auto-creates an org verification record; the response/`get_deployment` then carries the DNS records to add. The deployment must be provisioned (422 otherwise).", {
+        deployment_pid: z.string().min(1),
+        domains: z.array(z.object({
+            domain: z.string().min(1),
+            is_primary: z.boolean().optional().describe("Mark this as the primary domain (at most one)"),
+        })).describe("The complete desired domain set; replaces the current set atomically"),
+    }, async ({ deployment_pid, domains }) => {
+        if (!hasOrg())
+            return { content: [{ type: "text", text: NO_ORG }] };
+        const normalized = domains.map((d) => ({ domain: normalizeDomain(d.domain), is_primary: d.is_primary ?? false }));
+        const result = await apiRequest(`${DEPLOYMENTS_BASE}/${deployment_pid}/domains`, {
+            method: "PATCH",
+            body: { domains: normalized },
+            toolName: "sync_deployment_domains",
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to sync domains (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "Domains updated. Add the DNS records shown, then call `verify_custom_domain` for each domain. `get_deployment` shows current domain status." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+    server.tool("add_deployment_domain", "Add (append) one custom domain to a deployment as its primary domain, keeping any existing domains. Auto-creates the org verification record and returns the DNS records (TXT + CNAME) to configure. After adding the records at your DNS provider, call `verify_custom_domain`. The deployment must be provisioned (422 otherwise).", {
+        deployment_pid: z.string().min(1),
+        domain: z.string().min(1).describe("e.g. app.example.com (scheme/path are stripped)"),
+    }, async ({ deployment_pid, domain }) => {
+        if (!hasOrg())
+            return { content: [{ type: "text", text: NO_ORG }] };
+        const result = await apiRequest(`${DEPLOYMENTS_BASE}/${deployment_pid}/domains`, {
+            method: "POST",
+            body: { domain: normalizeDomain(domain) },
+            toolName: "add_deployment_domain",
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to add domain (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "Domain added. Configure the DNS records returned below, then call `verify_custom_domain`." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+    server.tool("remove_deployment_domain", "Remove one custom domain from a deployment. The remaining domains are re-synced and primary metadata updated.", {
+        deployment_pid: z.string().min(1),
+        domain: z.string().min(1),
+    }, async ({ deployment_pid, domain }) => {
+        if (!hasOrg())
+            return { content: [{ type: "text", text: NO_ORG }] };
+        const result = await apiRequest(`${DEPLOYMENTS_BASE}/${deployment_pid}/domains/${encodeURIComponent(normalizeDomain(domain))}`, {
+            method: "DELETE",
+            toolName: "remove_deployment_domain",
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to remove domain (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "Domain removed." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+    server.tool("verify_custom_domain", "Check a custom domain's DNS records live and advance its verification. The domain must have been added to a deployment first. Outcomes: `verified` (both TXT + CNAME present → domain goes live with HTTPS); `ownership_verified` (TXT only - add the CNAME); `routing_configured` (CNAME only - add the TXT); or 422 `pending_verification` (neither found yet - DNS can take up to 48h). The `checks` object reports each record's status and expected value.", {
+        domain: z.string().min(1),
+    }, async ({ domain }) => {
+        if (!hasOrg())
+            return { content: [{ type: "text", text: NO_ORG }] };
+        const result = await apiRequest(`${CUSTOM_DOMAINS_BASE}/${encodeURIComponent(normalizeDomain(domain))}/verify`, {
+            method: "POST",
+            toolName: "verify_custom_domain",
+        });
+        if (!result.success) {
+            const parts = [
+                { type: "text", text: `Domain not fully verified yet (${result.statusCode}): ${result.message}` },
+            ];
+            if (result.data)
+                parts.push({ type: "text", text: JSON.stringify(result.data, null, 2) });
+            return { content: parts };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("list_custom_domains", "List all custom-domain verifications for the active organization, with each domain's status (pending_verification | ownership_verified | routing_configured | verified) and when it was verified.", {}, async () => {
+        if (!hasOrg())
+            return { content: [{ type: "text", text: NO_ORG }] };
+        const result = await apiRequest(CUSTOM_DOMAINS_BASE, {
+            toolName: "list_custom_domains",
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to list custom domains (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=deployment-domains.js.map

package/dist/tools/deployment-domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-domains.js","sourceRoot":"","sources":["../../src/tools/deployment-domains.ts"],"names":[],"mappings":"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"}

package/dist/tools/deployment-notifications.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDeploymentNotificationTools(server: McpServer): void;

package/dist/tools/deployment-notifications.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { apiRequest } from "../client.js";
+import { session } from "../session.js";
+/**
+ * Deployment notification bindings - link an existing org notification channel
+ * (the `nchan_...` channels from `list_notification_channels`) to a deployment,
+ * so it's notified on terminal deploy-run outcomes (succeeded / failed / aborted).
+ * Binding covers all terminal events; there is no per-event selection.
+ *
+ * Endpoints (base /api/v1/platform/github_repo_deployments/:pid/notifications):
+ * - GET    /notifications                  list enabled bindings
+ * - POST   /notifications                  bind a channel  (body {notification_channel_pid})
+ * - DELETE /notifications/:channel_pid     unbind a channel
+ *
+ * Note: only org OWNERS may manage these bindings. Create the channel itself via
+ * `create_notification_channel` first.
+ */
+const DEPLOYMENTS_BASE = "/api/v1/platform/github_repo_deployments";
+const NO_ORG = "No active organization. Call `list_organizations` then `select_organization` first.";
+function hasOrg() {
+    return session.getActiveOrgId() !== null;
+}
+export function registerDeploymentNotificationTools(server) {
+    server.tool("list_deployment_notification_bindings", "List the notification channels bound to a deployment (which channels get notified when a deploy succeeds/fails/aborts). Returns binding_pid, notification_channel_pid, channel_type, name, and bound_at.", {
+        deployment_pid: z.string().min(1),
+    }, async ({ deployment_pid }) => {
+        if (!hasOrg())
+            return { content: [{ type: "text", text: NO_ORG }] };
+        const result = await apiRequest(`${DEPLOYMENTS_BASE}/${deployment_pid}/notifications`, {
+            toolName: "list_deployment_notification_bindings",
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to list notification bindings (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("bind_deployment_notification_channel", "Bind an existing org notification channel to a deployment so it's notified on deploy outcomes. The channel pid (nchan_...) comes from `list_notification_channels` (create one with `create_notification_channel` if needed). Returns 422 if already bound, 404 if the channel doesn't exist. Org owner only.", {
+        deployment_pid: z.string().min(1),
+        notification_channel_pid: z.string().min(1).describe("Org notification channel pid, e.g. nchan_..."),
+    }, async ({ deployment_pid, notification_channel_pid }) => {
+        if (!hasOrg())
+            return { content: [{ type: "text", text: NO_ORG }] };
+        const result = await apiRequest(`${DEPLOYMENTS_BASE}/${deployment_pid}/notifications`, {
+            method: "POST",
+            body: { notification_channel_pid },
+            toolName: "bind_deployment_notification_channel",
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to bind notification channel (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "Notification channel bound to deployment." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+    server.tool("unbind_deployment_notification_channel", "Unbind a notification channel from a deployment (it will no longer be notified on deploy outcomes). Pass the notification_channel_pid (NOT the binding pid). Org owner only.", {
+        deployment_pid: z.string().min(1),
+        notification_channel_pid: z.string().min(1).describe("The notification channel pid (nchan_...) to unbind"),
+    }, async ({ deployment_pid, notification_channel_pid }) => {
+        if (!hasOrg())
+            return { content: [{ type: "text", text: NO_ORG }] };
+        const result = await apiRequest(`${DEPLOYMENTS_BASE}/${deployment_pid}/notifications/${notification_channel_pid}`, {
+            method: "DELETE",
+            toolName: "unbind_deployment_notification_channel",
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to unbind notification channel (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: "Notification channel unbound from deployment." }] };
+    });
+}
+//# sourceMappingURL=deployment-notifications.js.map

package/dist/tools/deployment-notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-notifications.js","sourceRoot":"","sources":["../../src/tools/deployment-notifications.ts"],"names":[],"mappings":"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"}

package/dist/tools/deployments.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDeploymentTools(server: McpServer): void;