@selfhost.dev/mcp-server 0.1.0

package/dist/tools/networking.js

@@ -0,0 +1,240 @@
+import { z } from "zod";
+import { apiRequest } from "../client.js";
+import { session } from "../session.js";
+/** Returns the org PID from the param or falls back to the active session org. */
+function resolveOrgId(organization_id) {
+    return organization_id || session.getActiveOrgId();
+}
+const noOrgMessage = "No organization selected. Call `select_organization` first or pass an organization_id.";
+const ipRangeSchema = z.object({
+    CidrIp: z.string(),
+    Description: z.string().optional(),
+});
+const ipv6RangeSchema = z.object({
+    CidrIpv6: z.string(),
+    Description: z.string().optional(),
+});
+const prefixListIdSchema = z.object({
+    PrefixListId: z.string(),
+    Description: z.string().optional(),
+});
+const userIdGroupPairSchema = z.object({
+    GroupId: z.string(),
+    Description: z.string().optional(),
+});
+const ipPermissionSchema = z.object({
+    IpProtocol: z.string().describe("Protocol: tcp, udp, icmp, or -1 for all"),
+    FromPort: z.number().optional(),
+    ToPort: z.number().optional(),
+    IpRanges: z.array(ipRangeSchema).optional(),
+    Ipv6Ranges: z.array(ipv6RangeSchema).optional(),
+    PrefixListIds: z.array(prefixListIdSchema).optional(),
+    UserIdGroupPairs: z.array(userIdGroupPairSchema).optional(),
+});
+export function registerNetworkingTools(server) {
+    // --- VPCs ---
+    server.tool("list_vpcs", `List VPCs in a region for an organization's AWS account. Returns VPCs grouped by type: "public" and "private".
+
+IMPORTANT: For instance creation, only use VPCs from the "public" group. Private VPCs are not supported for database instances.
+Pass the cloud_credential_id of the user's BYOC credential to see VPCs in their AWS account.`, {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        region: z.string().min(1, "AWS region is required (e.g. us-east-1)"),
+        cloud_credential_id: z.string().optional().describe("Credential PID (defaults to org default)"),
+    }, async ({ organization_id, region, cloud_credential_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: noOrgMessage }] };
+        }
+        const result = await apiRequest(`/aws/v1/organizations/${orgId}/vpcs`, {
+            toolName: "list_vpcs",
+            query: { region, cloud_credential_id },
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to list VPCs (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("create_vpc", "Create a VPC in a region. Automatically creates an internet gateway, route table, and up to 3 subnets.", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        region: z.string().min(1, "AWS region is required"),
+        cidr_block: z.string().min(1, "CIDR block is required (e.g. 10.0.0.0/16)"),
+        vpc_name: z.string().optional().describe("Name tag for the VPC"),
+        cloud_credential_id: z.string().optional().describe("Credential PID (defaults to org default)"),
+    }, async ({ organization_id, region, cidr_block, vpc_name, cloud_credential_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: noOrgMessage }] };
+        }
+        const result = await apiRequest(`/aws/v1/organizations/${orgId}/vpcs`, {
+            method: "POST",
+            body: { region, cidr_block, vpc_name, cloud_credential_id },
+            toolName: "create_vpc",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to create VPC (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "VPC created." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+    server.tool("delete_vpc", "DESTRUCTIVE: Delete a VPC by its AWS VPC ID. Removes the VPC and associated resources (subnets, route tables, internet gateway) from AWS. You MUST set confirm=true to proceed.", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        vpc_id: z.string().min(1, "VPC ID is required (e.g. vpc-abc123)"),
+        cloud_credential_id: z.string().optional().describe("Credential PID (defaults to org default)"),
+        confirm: z.boolean().describe("Must be true to proceed. Ask the user for explicit confirmation before setting this."),
+    }, async ({ organization_id, vpc_id, cloud_credential_id, confirm }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: noOrgMessage }] };
+        }
+        if (!confirm) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `You are about to DELETE VPC ${vpc_id} and all associated AWS resources (subnets, route tables, internet gateway).\n\nTo proceed, call this tool again with confirm=true.`,
+                    }],
+            };
+        }
+        const result = await apiRequest(`/aws/v1/organizations/${orgId}/vpcs/${vpc_id}`, {
+            method: "DELETE",
+            query: { cloud_credential_id },
+            toolName: "delete_vpc",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to delete VPC (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: `VPC ${vpc_id} deleted.` }] };
+    });
+    // --- Subnets ---
+    server.tool("list_subnets", "List subnets in a region for an organization's AWS account.", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        region: z.string().min(1, "AWS region is required"),
+        cloud_credential_id: z.string().optional().describe("Credential PID (defaults to org default)"),
+    }, async ({ organization_id, region, cloud_credential_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: noOrgMessage }] };
+        }
+        const result = await apiRequest(`/aws/v1/organizations/${orgId}/subnets`, {
+            toolName: "list_subnets",
+            query: { region, cloud_credential_id },
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to list subnets (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("create_subnet", "Create a subnet in a VPC. Requires region, vpc_id, cidr_block, and availability_zone.", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        region: z.string().min(1, "AWS region is required"),
+        vpc_id: z.string().min(1, "VPC ID is required"),
+        name: z.string().min(1, "Subnet name is required"),
+        cidr_block: z.string().min(1, "CIDR block is required (e.g. 10.0.1.0/24)"),
+        availability_zone: z.string().min(1, "Availability zone is required (e.g. us-east-1a)"),
+        cloud_credential_id: z.string().optional().describe("Credential PID (defaults to org default)"),
+    }, async ({ organization_id, region, vpc_id, name, cidr_block, availability_zone, cloud_credential_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: noOrgMessage }] };
+        }
+        const result = await apiRequest(`/aws/v1/organizations/${orgId}/subnets`, {
+            method: "POST",
+            body: { region, vpc_id, name, cidr_block, availability_zone, cloud_credential_id },
+            toolName: "create_subnet",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to create subnet (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "Subnet created." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+    // --- Security Groups ---
+    server.tool("list_security_groups", "List security groups in a region for an organization's AWS account.", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        region: z.string().min(1, "AWS region is required"),
+        cloud_credential_id: z.string().optional().describe("Credential PID (defaults to org default)"),
+    }, async ({ organization_id, region, cloud_credential_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: noOrgMessage }] };
+        }
+        const result = await apiRequest(`/aws/v1/organizations/${orgId}/security_groups`, {
+            toolName: "list_security_groups",
+            query: { region, cloud_credential_id },
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to list security groups (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("create_security_group", "Create a security group in a VPC with optional inbound rules (ip_permissions).", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        region: z.string().min(1, "AWS region is required"),
+        group_name: z.string().min(1, "Security group name is required"),
+        description: z.string().min(1, "Description is required"),
+        vpc_id: z.string().min(1, "VPC ID is required"),
+        ip_permissions: z.array(ipPermissionSchema).optional().describe("Inbound rules (AWS format)"),
+        cloud_credential_id: z.string().optional().describe("Credential PID (defaults to org default)"),
+    }, async ({ organization_id, region, group_name, description, vpc_id, ip_permissions, cloud_credential_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: noOrgMessage }] };
+        }
+        const result = await apiRequest(`/aws/v1/organizations/${orgId}/security_groups`, {
+            method: "POST",
+            body: { region, group_name, description, vpc_id, ip_permissions, cloud_credential_id },
+            toolName: "create_security_group",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to create security group (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "Security group created." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+    server.tool("update_security_group", "Update a security group's inbound rules. WARNING: This REPLACES all existing inbound rules with the provided ones. Egress rules are not affected.", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        region: z.string().min(1, "AWS region is required"),
+        security_group_id: z.string().min(1, "Security group ID is required (e.g. sg-abc123)"),
+        ip_permissions: z.array(ipPermissionSchema).min(1, "At least one inbound rule is required"),
+        cloud_credential_id: z.string().optional().describe("Credential PID (defaults to org default)"),
+    }, async ({ organization_id, region, security_group_id, ip_permissions, cloud_credential_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: noOrgMessage }] };
+        }
+        const result = await apiRequest(`/aws/v1/organizations/${orgId}/security_groups/${security_group_id}`, {
+            method: "PUT",
+            body: { region, security_group_id, ip_permissions, cloud_credential_id },
+            toolName: "update_security_group",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to update security group (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "Security group inbound rules updated." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=networking.js.map

package/dist/tools/networking.js.map

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

package/dist/tools/organizations.d.ts

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

package/dist/tools/organizations.js

@@ -0,0 +1,260 @@
+import { z } from "zod";
+import { apiRequest } from "../client.js";
+import { session } from "../session.js";
+/** Returns the org PID from the param or falls back to the active session org. */
+function resolveOrgId(organization_id) {
+    return organization_id || session.getActiveOrgId();
+}
+export function registerOrganizationTools(server) {
+    server.tool("list_organizations", "List all organizations you belong to", {}, async () => {
+        const result = await apiRequest("/organizations", {
+            toolName: "list_organizations",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to list organizations (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("create_organization", "Create a new organization (limit: 1 per user). You become the owner and receive 5 invite credits.", {
+        name: z.string().min(2).max(100, "Name must be 2-100 characters"),
+        description: z.string().optional(),
+        default_instance_iam_role_arn: z.string().optional(),
+    }, async ({ name, description, default_instance_iam_role_arn }) => {
+        const body = {
+            organization: { name, description, default_instance_iam_role_arn },
+        };
+        const result = await apiRequest("/organizations", {
+            method: "POST",
+            body,
+            toolName: "create_organization",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to create organization (${result.statusCode}): ${result.message}` }] };
+        }
+        const org = result.data;
+        // Auto-select the newly created org
+        session.setActiveOrg({
+            id: org.id,
+            name: org.name,
+            billingPlan: org.billing_plan ?? "free",
+        });
+        return {
+            content: [
+                { type: "text", text: `Organization "${org.name}" created. You are now working in this org.` },
+                { type: "text", text: JSON.stringify(org, null, 2) },
+            ],
+        };
+    });
+    server.tool("get_organization", "Get details of an organization (defaults to your active org)", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+    }, async ({ organization_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: "No organization selected. Call `select_organization` first or pass an organization_id." }] };
+        }
+        const result = await apiRequest(`/organizations/${orgId}`, {
+            toolName: "get_organization",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to get organization (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("update_organization", "Update an organization's name, description, or IAM role (requires owner or admin role)", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        name: z.string().min(2).max(100).optional(),
+        description: z.string().optional(),
+        default_instance_iam_role_arn: z.string().optional(),
+    }, async ({ organization_id, name, description, default_instance_iam_role_arn }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: "No organization selected. Call `select_organization` first or pass an organization_id." }] };
+        }
+        const result = await apiRequest(`/organizations/${orgId}`, {
+            method: "PUT",
+            body: { organization: { name, description, default_instance_iam_role_arn } },
+            toolName: "update_organization",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to update organization (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "Organization updated." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+    server.tool("delete_organization", "DESTRUCTIVE: Delete an organization (requires owner or admin role). This soft-deletes the org and all related resources. You MUST set confirm=true to proceed.", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        confirm: z.boolean().describe("Must be true to proceed. Ask the user for explicit confirmation before setting this."),
+    }, async ({ organization_id, confirm }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: "No organization selected. Call `select_organization` first or pass an organization_id." }] };
+        }
+        if (!confirm) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `You are about to DELETE organization ${orgId}. This will soft-delete the org and ALL related resources (instances, credentials, backups, etc.).\n\nTo proceed, call this tool again with confirm=true.`,
+                    }],
+            };
+        }
+        const result = await apiRequest(`/organizations/${orgId}`, {
+            method: "DELETE",
+            toolName: "delete_organization",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to delete organization (${result.statusCode}): ${result.message}` }] };
+        }
+        // Clear session if the deleted org was the active one
+        if (session.getActiveOrgId() === orgId) {
+            session.clear();
+        }
+        return { content: [{ type: "text", text: `Organization ${orgId} deleted.` }] };
+    });
+    server.tool("list_members", "List members of an organization with their roles", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+    }, async ({ organization_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: "No organization selected. Call `select_organization` first or pass an organization_id." }] };
+        }
+        const result = await apiRequest(`/organizations/${orgId}/members`, {
+            toolName: "list_members",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to list members (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("remove_member", "DESTRUCTIVE: Remove a member from an organization (requires owner or admin role). Cannot remove the last owner. You MUST set confirm=true to proceed.", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        user_id: z.string().min(1, "User PID is required"),
+        confirm: z.boolean().describe("Must be true to proceed. Ask the user for explicit confirmation before setting this."),
+    }, async ({ organization_id, user_id, confirm }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: "No organization selected. Call `select_organization` first or pass an organization_id." }] };
+        }
+        if (!confirm) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `You are about to REMOVE member ${user_id} from organization ${orgId}. They will lose access to all org resources.\n\nTo proceed, call this tool again with confirm=true.`,
+                    }],
+            };
+        }
+        const result = await apiRequest(`/organizations/${orgId}/members/${user_id}`, {
+            method: "DELETE",
+            toolName: "remove_member",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to remove member (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: `Member ${user_id} removed from organization.` }] };
+    });
+    server.tool("invite_to_org", "Invite a user to your organization by email. Requires members:invite permission. Role hierarchy is enforced (can only invite at or below your role).", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        email: z.string().email("Valid email is required"),
+        role_pid: z.string().min(1, "Role PID is required (e.g. role PID for member, admin, etc.)"),
+    }, async ({ organization_id, email, role_pid }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: "No organization selected. Call `select_organization` first or pass an organization_id." }] };
+        }
+        const result = await apiRequest(`/organizations/${orgId}/invitations`, {
+            method: "POST",
+            body: { email, role_pid },
+            toolName: "invite_to_org",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to send invitation (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: `Invitation sent to ${email}.` },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+    server.tool("list_org_invitations", "List pending invitations for an organization", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+    }, async ({ organization_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: "No organization selected. Call `select_organization` first or pass an organization_id." }] };
+        }
+        const result = await apiRequest(`/organizations/${orgId}/invitations`, {
+            toolName: "list_org_invitations",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to list invitations (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("cancel_invitation", "DESTRUCTIVE: Cancel a pending organization invitation. You MUST set confirm=true to proceed.", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+        invitation_id: z.string().min(1, "Invitation PID is required"),
+        confirm: z.boolean().describe("Must be true to proceed. Ask the user for explicit confirmation before setting this."),
+    }, async ({ organization_id, invitation_id, confirm }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: "No organization selected. Call `select_organization` first or pass an organization_id." }] };
+        }
+        if (!confirm) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `You are about to CANCEL invitation ${invitation_id}. The invited user will no longer be able to join.\n\nTo proceed, call this tool again with confirm=true.`,
+                    }],
+            };
+        }
+        const result = await apiRequest(`/organizations/${orgId}/invitations/${invitation_id}`, {
+            method: "DELETE",
+            toolName: "cancel_invitation",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to cancel invitation (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: `Invitation ${invitation_id} cancelled.` }] };
+    });
+    server.tool("get_my_invitations", "List pending organization invitations sent to you", {}, async () => {
+        const result = await apiRequest("/my_invitations", {
+            toolName: "get_my_invitations",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to get invitations (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("list_activity_logs", "List activity logs for an organization (audit trail of actions)", {
+        organization_id: z.string().optional().describe("Organization PID (defaults to active org)"),
+    }, async ({ organization_id }) => {
+        const orgId = resolveOrgId(organization_id);
+        if (!orgId) {
+            return { content: [{ type: "text", text: "No organization selected. Call `select_organization` first or pass an organization_id." }] };
+        }
+        const result = await apiRequest(`/organizations/${orgId}/activity_logs`, {
+            toolName: "list_activity_logs",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to list activity logs (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+}
+//# sourceMappingURL=organizations.js.map

package/dist/tools/organizations.js.map

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

package/dist/tools/pg-config.d.ts

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

package/dist/tools/pg-config.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { apiRequest } from "../client.js";
+const pgConfigSchema = z.object({
+    shared_buffers: z.unknown().optional().describe("Shared memory for caching (e.g. '256MB'). Set null to revert to default."),
+    effective_cache_size: z.unknown().optional().describe("Planner estimate of OS cache (e.g. '768MB'). Set null to revert."),
+    random_page_cost: z.unknown().optional().describe("Cost of non-sequential page fetch (e.g. 1.1). Set null to revert."),
+    work_mem: z.unknown().optional().describe("Memory per sort/hash operation (e.g. '4MB'). Set null to revert."),
+    maintenance_work_mem: z.unknown().optional().describe("Memory for maintenance ops (e.g. '64MB'). Set null to revert."),
+    max_connections: z.unknown().optional().describe("Max concurrent connections (e.g. 100). Set null to revert. Requires restart."),
+}).describe("PostgreSQL configuration overrides");
+export function registerPgConfigTools(server) {
+    server.tool("preview_pg_config", "Preview calculated PostgreSQL configuration defaults for an instance type and region. Use this to see what values will be auto-calculated before creating or tuning an instance.", {
+        instance_type: z.string().min(1, "EC2 instance type is required (e.g. t3.medium)"),
+        region: z.string().min(1, "AWS region is required"),
+    }, async ({ instance_type, region }) => {
+        const result = await apiRequest("/aws/v1/postgresql_configs/preview", {
+            toolName: "preview_pg_config",
+            query: { instance_type, region },
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to preview PG config (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("get_pg_config", "Get the current PostgreSQL configuration for a running instance, showing calculated defaults, overrides, and effective values.", {
+        instance_pid: z.string().min(1, "Instance PID is required"),
+    }, async ({ instance_pid }) => {
+        const result = await apiRequest(`/aws/v1/instances/${instance_pid}/postgresql_config`, {
+            toolName: "get_pg_config",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to get PG config (${result.statusCode}): ${result.message}` }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }] };
+    });
+    server.tool("update_pg_config", "Update PostgreSQL configuration parameters on a running instance. Set a value to null to revert to the calculated default. shared_buffers and max_connections require a restart. Changes auto-sync to replicas.", {
+        instance_pid: z.string().min(1, "Instance PID is required"),
+        postgresql_config: pgConfigSchema,
+    }, async ({ instance_pid, postgresql_config }) => {
+        const result = await apiRequest(`/aws/v1/instances/${instance_pid}/postgresql_config`, {
+            method: "PATCH",
+            body: { postgresql_config },
+            toolName: "update_pg_config",
+            skipOrgInjection: true,
+        });
+        if (!result.success) {
+            return { content: [{ type: "text", text: `Failed to update PG config (${result.statusCode}): ${result.message}` }] };
+        }
+        return {
+            content: [
+                { type: "text", text: "PostgreSQL configuration updated." },
+                { type: "text", text: JSON.stringify(result.data, null, 2) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=pg-config.js.map

package/dist/tools/pg-config.js.map

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