Railway MCP Server

Instructions

Implementation Reference

• src/tools/service.tool.ts:185-187 (handler)

  The handler function that executes the service_delete tool logic by calling serviceService.deleteService
  async ({ projectId, serviceId }) => { return serviceService.deleteService(projectId, serviceId); }
• src/tools/service.tool.ts:182-184 (schema)

  Zod schema defining input parameters for the service_delete tool: projectId and serviceId
  projectId: z.string().describe("ID of the project containing the service"), serviceId: z.string().describe("ID of the service to delete") },
• src/tools/service.tool.ts:161-188 (registration)

  Registration of the service_delete tool using createTool, including description, schema, and handler
  createTool( "service_delete", formatToolDescription({ type: 'API', description: "Delete a service from a project", bestFor: [ "Removing unused services", "Cleaning up test services", "Project reorganization" ], notFor: [ "Temporary service stoppage (use service_restart)", "Updating service configuration (use service_update)" ], relations: { prerequisites: ["service_list", "service_info"], alternatives: ["service_restart"], related: ["project_delete"] } }), { projectId: z.string().describe("ID of the project containing the service"), serviceId: z.string().describe("ID of the service to delete") }, async ({ projectId, serviceId }) => { return serviceService.deleteService(projectId, serviceId); } ),
• src/services/service.service.ts:141-150 (helper)

  Helper method serviceService.deleteService that performs the deletion and handles response/error
  async deleteService(projectId: string, serviceId: string) { try { await this.client.services.deleteService(serviceId); return createSuccessResponse({ text: `Service deleted successfully` }); } catch (error) { return createErrorResponse(`Error deleting service: ${formatError(error)}`); } }
• src/api/repository/service.repo.ts:138-144 (helper)

  Repository method that executes the GraphQL mutation for service deletion
  async deleteService(serviceId: string): Promise<void> { await this.client.request<{ serviceDelete: boolean }>(` mutation serviceDelete($serviceId: String!) { serviceDelete(id: $serviceId) } `, { serviceId }); }