Railway MCP Server

Instructions

Implementation Reference

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

  Registration of the 'domain_delete' MCP tool using createTool, including detailed description, input schema (id: string), and handler 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/services/domain.service.ts:40-55 (helper)

  domainService.deleteServiceDomain(id) method: service layer implementation that calls the repository's serviceDomainDelete and wraps response in success/error format

  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 serviceDomainDelete(id): executes GraphQL mutation to delete the service domain via Railway API

  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;
  }