railway-mcp

Instructions

Implementation Reference

• src/tools/domain.tool.ts:123-149 (handler)

  Primary implementation of the domain_delete tool: includes description, input schema, and handler function that delegates to domainService.deleteServiceDomain(id)

  createTool(
    "domain_delete",
    formatToolDescription({
      type: 'API',
      description: "Delete a domain from a service",
      bestFor: [
        "Removing unused domains",
        "Cleaning up configurations",
        "Domain management"
      ],
      notFor: [
        "Temporary domain disabling",
        "Port updates (use domain_update)"
      ],
      relations: {
        prerequisites: ["domain_list"],
        alternatives: ["domain_update"],
        related: ["service_update"]
      }
    }),
    {
      id: z.string().describe("ID of the domain to delete")
    },
    async ({ id }) => {
      return domainService.deleteServiceDomain(id);
    }
  )

• src/tools/domain.tool.ts:143-145 (schema)

  Zod input schema for the domain_delete tool requiring the domain ID

  {
    id: z.string().describe("ID of the domain to delete")
  },

• src/tools/index.ts:16-37 (registration)

  Registers all tool sets to the MCP server, including domainTools which contains domain_delete

  export function registerAllTools(server: McpServer) {
    // Collect all tools
    const allTools = [
      ...databaseTools,
      ...deploymentTools,
      ...domainTools,
      ...projectTools,
      ...serviceTools,
      ...tcpProxyTools,
      ...variableTools,
      ...configTools,
      ...volumeTools,
      ...templateTools,
    ] as Tool[];
  
    // Register each tool with the server
    allTools.forEach((tool) => {
      server.tool(
        ...tool
      );
    });
  } 

• src/services/domain.service.ts:40-55 (helper)

  Service layer wrapper for deleting a service domain, calls repository serviceDomainDelete and formats response

  async deleteServiceDomain(id: string): Promise<CallToolResult> {
    try {
      const result = await this.client.domains.serviceDomainDelete(id);
      
      if (result) {
        return createSuccessResponse({
          text: `Domain with ID ${id} deleted successfully`,
          data: { success: true }
        });
      } else {
        return createErrorResponse(`Failed to delete domain with ID ${id}`);
      }
    } catch (error) {
      return createErrorResponse(`Error deleting domain: ${formatError(error)}`);
    }
  }

• src/api/repository/domain.repo.ts:30-40 (helper)

  Repository method executing the GraphQL mutation to delete the service domain

  async serviceDomainDelete(id: string): Promise<boolean> {
    const query = `
      mutation serviceDomainDelete($id: String!) {
        serviceDomainDelete(id: $id)
      }
    `;
  
    const variables = { id };
    const response = await this.client.request<{ serviceDomainDelete: boolean }>(query, variables);
    return response.serviceDomainDelete;
  }