rename variables (#45)

Author: electather

AGENT.md

@@ -10,13 +10,13 @@ metadata:
   author: electather
   repo: https://github.com/electather/seerr-cli
 env:
-  - name: SEER_SERVER
+  - name: SEERR_SERVER
     description: Full URL of your Seerr instance (e.g. https://seerr.example.com)
     required: true
-  - name: SEER_API_KEY
+  - name: SEERR_API_KEY
     description: API key for authenticating with the Seerr server
     required: true
-  - name: SEER_MCP_AUTH_TOKEN
+  - name: SEERR_MCP_AUTH_TOKEN
     description: Bearer token for authenticating MCP HTTP transport clients (required when running the HTTP server; omit for stdio transport)
     required: false
 ---
@@ -47,9 +47,9 @@ Run the MCP HTTP server in a container next to your Seerr instance:
 ```bash
 # With Bearer token auth
 docker run --rm \
-  -e SEER_SERVER=http://your-seerr-instance:5055 \
-  -e SEER_API_KEY=your-api-key \
-  -e SEER_MCP_AUTH_TOKEN=your-secret-token \
+  -e SEERR_SERVER=http://your-seerr-instance:5055 \
+  -e SEERR_API_KEY=your-api-key \
+  -e SEERR_MCP_AUTH_TOKEN=your-secret-token \
   -p 8811:8811 \
   ghcr.io/electather/seerr-cli:latest
 ```
@@ -60,37 +60,37 @@ For clients that cannot send custom headers (e.g. claude.ai remote MCP), use a s
 
 ```bash
 docker run --rm \
-  -e SEER_SERVER=http://your-seerr-instance:5055 \
-  -e SEER_API_KEY=your-api-key \
-  -e SEER_MCP_ROUTE_TOKEN=your-secret-path \
-  -e SEER_MCP_NO_AUTH=true \
-  -e SEER_MCP_CORS=true \
+  -e SEERR_SERVER=http://your-seerr-instance:5055 \
+  -e SEERR_API_KEY=your-api-key \
+  -e SEERR_MCP_ROUTE_TOKEN=your-secret-path \
+  -e SEERR_MCP_NO_AUTH=true \
+  -e SEERR_MCP_CORS=true \
   -p 8811:8811 \
   ghcr.io/electather/seerr-cli:latest
 ```
 
 MCP endpoint: `http://localhost:8811/your-secret-path/mcp` — no auth header required.
 
-At least one of `SEER_MCP_AUTH_TOKEN`, `SEER_MCP_ROUTE_TOKEN`, or `SEER_MCP_NO_AUTH=true` must be set for HTTP transport.
+At least one of `SEERR_MCP_AUTH_TOKEN`, `SEERR_MCP_ROUTE_TOKEN`, or `SEERR_MCP_NO_AUTH=true` must be set for HTTP transport.
 
 ### docker-compose deployment
 
 Use the included `docker-compose.yml` to deploy alongside Seer:
 
 ```bash
-SEER_API_KEY=xxx SEER_MCP_AUTH_TOKEN=secret docker compose up -d
+SEERR_API_KEY=xxx SEERR_MCP_AUTH_TOKEN=secret docker compose up -d
 ```
 
-The default `SEER_SERVER` in the compose file points to `http://seer:5055` (the Seerr service name). Override it if your Seerr instance is elsewhere.
+The default `SEERR_SERVER` in the compose file points to `http://seer:5055` (the Seerr service name). Override it if your Seerr instance is elsewhere.
 
 ### Running CLI commands via Docker
 
 Override the default CMD to run any CLI command:
 
 ```bash
 docker run --rm \
-  -e SEER_SERVER=http://your-seerr-instance:5055 \
-  -e SEER_API_KEY=your-api-key \
+  -e SEERR_SERVER=http://your-seerr-instance:5055 \
+  -e SEERR_API_KEY=your-api-key \
   ghcr.io/electather/seerr-cli:latest \
   status system
 ```
@@ -102,7 +102,7 @@ seerr-cli config set --server https://your-seerr-instance.com --api-key YOUR_KEY
 seerr-cli config show   # verify
 ```
 
-Environment variables also work: `SEER_SERVER`, `SEER_API_KEY`.
+Environment variables also work: `SEERR_SERVER`, `SEERR_API_KEY`.
 
 ## Global Flags
 
@@ -331,8 +331,8 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
       "command": "/usr/local/bin/seerr-cli",
       "args": ["mcp", "serve"],
       "env": {
-        "SEER_SERVER": "https://your-seerr-instance.com",
-        "SEER_API_KEY": "your-api-key"
+        "SEERR_SERVER": "https://your-seerr-instance.com",
+        "SEERR_API_KEY": "your-api-key"
       }
     }
   }
@@ -349,7 +349,7 @@ seerr-cli mcp serve --transport http --addr :8811 --auth-token mysecrettoken
 
 Endpoint: `http://localhost:8811/mcp` — set `Authorization: Bearer mysecrettoken` in your client.
 
-For clients that cannot send custom headers (e.g. claude.ai remote MCP), use a secret path prefix via `--route-token` (or `SEER_MCP_ROUTE_TOKEN`):
+For clients that cannot send custom headers (e.g. claude.ai remote MCP), use a secret path prefix via `--route-token` (or `SEERR_MCP_ROUTE_TOKEN`):
 
 ```bash
 # Add --cors if connecting from a browser-based client (e.g. claude.ai)
@@ -365,18 +365,18 @@ seerr-cli mcp serve --transport http --route-token abc123 --auth-token mysecrett
 
 All flags are configurable via environment variables:
 
-| Flag            | Environment variable   | Default |
-| --------------- | ---------------------- | ------- |
-| `--transport`   | `SEER_MCP_TRANSPORT`   | `stdio` |
-| `--addr`        | `SEER_MCP_ADDR`        | `:8811` |
-| `--auth-token`  | `SEER_MCP_AUTH_TOKEN`  | —       |
-| `--no-auth`     | `SEER_MCP_NO_AUTH`     | `false` |
-| `--route-token` | `SEER_MCP_ROUTE_TOKEN` | —       |
-| `--cors`        | `SEER_MCP_CORS`        | `false` |
-| `--tls-cert`    | `SEER_MCP_TLS_CERT`    | —       |
-| `--tls-key`     | `SEER_MCP_TLS_KEY`     | —       |
-
-> Pass `--cors` (or `SEER_MCP_CORS=true`) to enable CORS headers for browser-based clients (e.g. claude.ai). Disabled by default.
+| Flag            | Environment variable    | Default |
+| --------------- | ----------------------- | ------- |
+| `--transport`   | `SEERR_MCP_TRANSPORT`   | `stdio` |
+| `--addr`        | `SEERR_MCP_ADDR`        | `:8811` |
+| `--auth-token`  | `SEERR_MCP_AUTH_TOKEN`  | —       |
+| `--no-auth`     | `SEERR_MCP_NO_AUTH`     | `false` |
+| `--route-token` | `SEERR_MCP_ROUTE_TOKEN` | —       |
+| `--cors`        | `SEERR_MCP_CORS`        | `false` |
+| `--tls-cert`    | `SEERR_MCP_TLS_CERT`    | —       |
+| `--tls-key`     | `SEERR_MCP_TLS_KEY`     | —       |
+
+> Pass `--cors` (or `SEERR_MCP_CORS=true`) to enable CORS headers for browser-based clients (e.g. claude.ai). Disabled by default.
 
 > The HTTP transport does not implement OAuth 2.0. Use stdio for Claude Desktop.
 

CLAUDE.md

@@ -81,7 +81,7 @@ Global flags (`--server`, `--api-key`, `--verbose`) are bound to Viper keys `ser
 ### Testing Conventions
 
 - Mock HTTP with `httptest.NewServer()` — no live network calls.
-- Set `<group>.OverrideServerURL = ts.URL` and `os.Setenv("SEER_SERVER", ts.URL)`, clean up with `defer`.
+- Set `<group>.OverrideServerURL = ts.URL` and `os.Setenv("SEERR_SERVER", ts.URL)`, clean up with `defer`.
 - Capture output with `cmd.RootCmd.SetOut(&buf)`, then call `cmd.RootCmd.Execute()`.
 - **Do not assert on verbose/log output strings** — only assert on functional data (JSON fields, exit behavior).
 

README.md

@@ -37,18 +37,18 @@ The image defaults to running the MCP HTTP server on port `8811`. Pass configura
 ```sh
 docker run -d \
   -p 8811:8811 \
-  -e SEER_SERVER=https://your-seerr-instance.com \
-  -e SEER_API_KEY=your-api-key \
-  -e SEER_MCP_AUTH_TOKEN=mysecrettoken \
+  -e SEERR_SERVER=https://your-seerr-instance.com \
+  -e SEERR_API_KEY=your-api-key \
+  -e SEERR_MCP_AUTH_TOKEN=mysecrettoken \
   ghcr.io/electather/seerr-cli:latest
 ```
 
 To run CLI commands instead, override the default arguments:
 
 ```sh
 docker run --rm \
-  -e SEER_SERVER=https://your-seerr-instance.com \
-  -e SEER_API_KEY=your-api-key \
+  -e SEERR_SERVER=https://your-seerr-instance.com \
+  -e SEERR_API_KEY=your-api-key \
   ghcr.io/electather/seerr-cli:latest \
   status system
 ```
@@ -64,8 +64,8 @@ seerr-cli config set --server https://your-seerr-instance.com --api-key YOUR_KEY
 Configuration is stored in `~/.seerr-cli.yaml`. You can also use environment variables:
 
 ```sh
-export SEER_SERVER=https://your-seerr-instance.com
-export SEER_API_KEY=YOUR_KEY
+export SEERR_SERVER=https://your-seerr-instance.com
+export SEERR_API_KEY=YOUR_KEY
 ```
 
 Or pass them as flags on any command:
@@ -344,8 +344,8 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
       "command": "/usr/local/bin/seerr-cli",
       "args": ["mcp", "serve"],
       "env": {
-        "SEER_SERVER": "https://your-seerr-instance.com",
-        "SEER_API_KEY": "your-api-key"
+        "SEERR_SERVER": "https://your-seerr-instance.com",
+        "SEERR_API_KEY": "your-api-key"
       }
     }
   }
@@ -397,16 +397,16 @@ seerr-cli mcp serve --transport http --addr :8811 --route-token abc123 --auth-to
 
 All `mcp serve` flags can be set via environment variables, which is especially useful for Docker deployments:
 
-| Flag            | Environment variable   | Default |
-| --------------- | ---------------------- | ------- |
-| `--transport`   | `SEER_MCP_TRANSPORT`   | `stdio` |
-| `--addr`        | `SEER_MCP_ADDR`        | `:8811` |
-| `--auth-token`  | `SEER_MCP_AUTH_TOKEN`  | —       |
-| `--no-auth`     | `SEER_MCP_NO_AUTH`     | `false` |
-| `--route-token` | `SEER_MCP_ROUTE_TOKEN` | —       |
-| `--cors`        | `SEER_MCP_CORS`        | `false` |
-| `--tls-cert`    | `SEER_MCP_TLS_CERT`    | —       |
-| `--tls-key`     | `SEER_MCP_TLS_KEY`     | —       |
+| Flag            | Environment variable    | Default |
+| --------------- | ----------------------- | ------- |
+| `--transport`   | `SEERR_MCP_TRANSPORT`   | `stdio` |
+| `--addr`        | `SEERR_MCP_ADDR`        | `:8811` |
+| `--auth-token`  | `SEERR_MCP_AUTH_TOKEN`  | —       |
+| `--no-auth`     | `SEERR_MCP_NO_AUTH`     | `false` |
+| `--route-token` | `SEERR_MCP_ROUTE_TOKEN` | —       |
+| `--cors`        | `SEERR_MCP_CORS`        | `false` |
+| `--tls-cert`    | `SEERR_MCP_TLS_CERT`    | —       |
+| `--tls-key`     | `SEERR_MCP_TLS_KEY`     | —       |
 
 ### Docker (HTTP transport)
 
@@ -417,9 +417,9 @@ The published container image runs the MCP HTTP server by default. This is the r
 docker run -d \
   --name seerr-mcp \
   -p 8811:8811 \
-  -e SEER_SERVER=https://your-seerr-instance.com \
-  -e SEER_API_KEY=your-api-key \
-  -e SEER_MCP_AUTH_TOKEN=mysecrettoken \
+  -e SEERR_SERVER=https://your-seerr-instance.com \
+  -e SEERR_API_KEY=your-api-key \
+  -e SEERR_MCP_AUTH_TOKEN=mysecrettoken \
   ghcr.io/electather/seerr-cli:latest
 ```
 
@@ -434,11 +434,11 @@ For clients that cannot send custom headers (e.g. claude.ai remote MCP), use a s
 docker run -d \
   --name seerr-mcp \
   -p 8811:8811 \
-  -e SEER_SERVER=https://your-seerr-instance.com \
-  -e SEER_API_KEY=your-api-key \
-  -e SEER_MCP_ROUTE_TOKEN=abc123 \
-  -e SEER_MCP_NO_AUTH=true \
-  -e SEER_MCP_CORS=true \
+  -e SEERR_SERVER=https://your-seerr-instance.com \
+  -e SEERR_API_KEY=your-api-key \
+  -e SEERR_MCP_ROUTE_TOKEN=abc123 \
+  -e SEERR_MCP_NO_AUTH=true \
+  -e SEERR_MCP_CORS=true \
   ghcr.io/electather/seerr-cli:latest
 ```
 
@@ -451,9 +451,9 @@ To bind to a different port or address, pass `--addr` explicitly:
 ```sh
 docker run -d \
   -p 9000:9000 \
-  -e SEER_SERVER=https://your-seerr-instance.com \
-  -e SEER_API_KEY=your-api-key \
-  -e SEER_MCP_AUTH_TOKEN=mysecrettoken \
+  -e SEERR_SERVER=https://your-seerr-instance.com \
+  -e SEERR_API_KEY=your-api-key \
+  -e SEERR_MCP_AUTH_TOKEN=mysecrettoken \
   ghcr.io/electather/seerr-cli:latest \
   mcp serve --transport http --addr :9000
 ```

cmd/mcp/flags.go

@@ -28,51 +28,51 @@ var ServeFlags = []FlagDef{
 		Name:     "transport",
 		ViperKey: "mcp.transport",
 		Default:  "stdio",
-		Usage:    "Transport protocol: stdio or http (env: SEER_MCP_TRANSPORT)",
+		Usage:    "Transport protocol: stdio or http (env: SEERR_MCP_TRANSPORT)",
 	},
 	{
 		Name:     "addr",
 		ViperKey: "mcp.addr",
 		Default:  ":8811",
-		Usage:    "HTTP bind address (http transport only) (env: SEER_MCP_ADDR)",
+		Usage:    "HTTP bind address (http transport only) (env: SEERR_MCP_ADDR)",
 	},
 	{
 		Name:     "auth-token",
 		ViperKey: "mcp.auth_token",
 		Default:  "",
-		Usage:    "Bearer token required for HTTP transport (env: SEER_MCP_AUTH_TOKEN)",
+		Usage:    "Bearer token required for HTTP transport (env: SEERR_MCP_AUTH_TOKEN)",
 	},
 	{
 		Name:     "no-auth",
 		ViperKey: "mcp.no_auth",
 		Default:  "false",
 		IsBool:   true,
-		Usage:    "Disable authentication (insecure — must be explicit) (env: SEER_MCP_NO_AUTH)",
+		Usage:    "Disable authentication (insecure — must be explicit) (env: SEERR_MCP_NO_AUTH)",
 	},
 	{
 		Name:     "route-token",
 		ViperKey: "mcp.route_token",
 		Default:  "",
-		Usage:    "Secret path prefix for the MCP endpoint (e.g. 'abc123' → /abc123/mcp) (env: SEER_MCP_ROUTE_TOKEN)",
+		Usage:    "Secret path prefix for the MCP endpoint (e.g. 'abc123' → /abc123/mcp) (env: SEERR_MCP_ROUTE_TOKEN)",
 	},
 	{
 		Name:     "tls-cert",
 		ViperKey: "mcp.tls_cert",
 		Default:  "",
-		Usage:    "Path to TLS certificate file (env: SEER_MCP_TLS_CERT)",
+		Usage:    "Path to TLS certificate file (env: SEERR_MCP_TLS_CERT)",
 	},
 	{
 		Name:     "tls-key",
 		ViperKey: "mcp.tls_key",
 		Default:  "",
-		Usage:    "Path to TLS private key file (env: SEER_MCP_TLS_KEY)",
+		Usage:    "Path to TLS private key file (env: SEERR_MCP_TLS_KEY)",
 	},
 	{
 		Name:     "cors",
 		ViperKey: "mcp.cors",
 		Default:  "false",
 		IsBool:   true,
-		Usage:    "Enable CORS headers (required for browser-based clients such as claude.ai) (env: SEER_MCP_CORS)",
+		Usage:    "Enable CORS headers (required for browser-based clients such as claude.ai) (env: SEERR_MCP_CORS)",
 	},
 	{
 		Name:     "multi-tenant",
@@ -85,19 +85,19 @@ var ServeFlags = []FlagDef{
 		Name:     "log-file",
 		ViperKey: "mcp.log_file",
 		Default:  "",
-		Usage:    "Path to log file; required for stdio transport to capture logs (env: SEER_MCP_LOG_FILE)",
+		Usage:    "Path to log file; required for stdio transport to capture logs (env: SEERR_MCP_LOG_FILE)",
 	},
 	{
 		Name:     "log-level",
 		ViperKey: "mcp.log_level",
 		Default:  "info",
-		Usage:    "Log level: debug, info, warn, error (env: SEER_MCP_LOG_LEVEL)",
+		Usage:    "Log level: debug, info, warn, error (env: SEERR_MCP_LOG_LEVEL)",
 	},
 	{
 		Name:     "log-format",
 		ViperKey: "mcp.log_format",
 		Default:  "text",
-		Usage:    "Log format: text or json (env: SEER_MCP_LOG_FORMAT)",
+		Usage:    "Log format: text or json (env: SEERR_MCP_LOG_FORMAT)",
 	},
 }
 

cmd/mcp/serve.go

@@ -106,7 +106,7 @@ func runServe(_ *cobra.Command, args []string) error {
 	case "stdio":
 		mcpLog.Info("starting MCP server",
 			"transport", "stdio",
-			"seer_api", seerServer,
+			"seerr_api", seerServer,
 			"tools", 44,
 		)
 		mcpLog.Debug("stdio transport ready, waiting for MCP client on stdin")
@@ -132,7 +132,7 @@ func runServe(_ *cobra.Command, args []string) error {
 		mcpLog.Info("starting MCP server",
 			"transport", "http",
 			"endpoint", endpoint,
-			"seer_api", seerServer,
+			"seerr_api", seerServer,
 			"tools", 44,
 			"tls", tlsCert != "",
 			"auth_token", authToken != "",

cmd/root.go

@@ -57,7 +57,7 @@ var RootCmd = &cobra.Command{
 			return nil
 		}
 		if viper.GetString("seerr.server") == "" {
-			return fmt.Errorf("server URL is required. Set it via --server flag, SEER_SERVER env var, or in the config file")
+			return fmt.Errorf("server URL is required. Set it via --server flag, SEERR_SERVER env var, or in the config file")
 		}
 		return nil
 	},
@@ -119,13 +119,13 @@ func initConfig() {
 
 	viper.SetEnvPrefix("SEER")
 	// Replace dots and hyphens so nested keys like "mcp.transport" map to
-	// env vars like "SEER_MCP_TRANSPORT".
+	// env vars like "SEERR_MCP_TRANSPORT".
 	viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_", "-", "_"))
 	viper.AutomaticEnv()
-	// AutomaticEnv with the SEERR prefix would construct "SEER_SEER_SERVER" for
+	// AutomaticEnv with the SEERR prefix would construct "SEERR_SEERR_SERVER" for
 	// the "seerr.server" key, so we bind those explicitly instead.
-	viper.BindEnv("seerr.server", "SEER_SERVER")
-	viper.BindEnv("seerr.api_key", "SEER_API_KEY")
+	viper.BindEnv("seerr.server", "SEERR_SERVER")
+	viper.BindEnv("seerr.api_key", "SEERR_API_KEY")
 
 	if err := viper.ReadInConfig(); err == nil {
 		if viper.GetBool("verbose") {