railway-mcp

Instructions

Implementation Reference

• src/tools/variable.tool.ts:65-94 (registration)

  Registration of the 'variable_delete' tool using createTool, including formatted description, Zod input schema, and handler function that delegates to variableService.deleteVariable

  createTool(
    "variable_delete",
    formatToolDescription({
      type: 'API',
      description: "Delete a variable for a service in a specific environment",
      bestFor: [
        "Removing unused configuration",
        "Security cleanup",
        "Configuration management"
      ],
      notFor: [
        "Temporary variable disabling",
        "Bulk variable removal"
      ],
      relations: {
        prerequisites: ["service_list"],
        nextSteps: ["deployment_trigger", "service_restart"],
        related: ["variable_list", "variable_set"]
      }
    }),
    {
      projectId: z.string().describe("ID of the project"),
      environmentId: z.string().describe("ID of the environment to delete the variable from (usually obtained from service_list)"),
      name: z.string().describe("Name of the variable to delete"),
      serviceId: z.string().optional().describe("ID of the service (optional, if omitted deletes a shared variable)")
    },
    async ({ projectId, environmentId, name, serviceId }) => {
      return variableService.deleteVariable(projectId, environmentId, name, serviceId);
    }
  ),

• src/tools/variable.tool.ts:91-93 (handler)

  The core handler function for the variable_delete tool, which invokes the variable service to perform the deletion

  async ({ projectId, environmentId, name, serviceId }) => {
    return variableService.deleteVariable(projectId, environmentId, name, serviceId);
  }

• src/tools/variable.tool.ts:85-89 (schema)

  Zod schema defining the input parameters for the variable_delete tool

  {
    projectId: z.string().describe("ID of the project"),
    environmentId: z.string().describe("ID of the environment to delete the variable from (usually obtained from service_list)"),
    name: z.string().describe("Name of the variable to delete"),
    serviceId: z.string().optional().describe("ID of the service (optional, if omitted deletes a shared variable)")

• src/services/variable.service.ts:56-72 (helper)

  VariableService.deleteVariable method: wraps the repository call, handles errors, and formats success/error responses

  async deleteVariable(projectId: string, environmentId: string, name: string, serviceId?: string) {
    try {
      await this.client.variables.deleteVariable({
        projectId,
        environmentId,
        name,
        serviceId
      });
  
      const variableType = serviceId ? "service variable" : "shared environment variable";
      return createSuccessResponse({
        text: `Successfully deleted ${variableType} "${name}"`
      });
    } catch (error) {
      return createErrorResponse(`Error deleting variable: ${formatError(error)}`);
    }
  }

• src/api/repository/variable.repo.ts:49-68 (helper)

  Repository layer executes the GraphQL mutation to delete the variable via Railway API

  async deleteVariable(input: VariableDeleteInput): Promise<void> {
    const { projectId, environmentId, serviceId, name } = input;
    await this.client.request<{ variableDelete: boolean }>(`
      mutation variableDelete(
        $projectId: String!,
        $environmentId: String!,
        $serviceId: String,
        $name: String!
      ) {
        variableDelete(
          input: {
            projectId: $projectId,
            environmentId: $environmentId,
            serviceId: $serviceId,
            name: $name
          }
        )
      }
    `, { projectId, environmentId, serviceId, name });
  }