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