Railway MCP Server

Instructions

Implementation Reference

• src/tools/service.tool.ts:161-188 (registration)

  Tool registration for 'service_delete', including Zod input schema, formatted description, and handler that calls serviceService.deleteService

  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 (handler)

  ServiceService.deleteService method: calls client.services.deleteService(serviceId) 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)

  ServiceRepository.deleteService: executes GraphQL mutation to delete the service via Railway API

  async deleteService(serviceId: string): Promise<void> {
    await this.client.request<{ serviceDelete: boolean }>(`
      mutation serviceDelete($serviceId: String!) {
        serviceDelete(id: $serviceId)
      }
    `, { serviceId });
  }