chatgpt-web-mcp
by UmutKDev
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | HTTP listening host. | 0.0.0.0 |
| PORT | No | HTTP listening port. | 8099 |
| HEADLESS | No | Docker image runs with Xvfb in visible mode. Headless mode triggers verification more often. | false |
| MCP_PATH | No | HTTP path for the MCP endpoint. | /mcp |
| LOG_LEVEL | No | Log level. Logs are written to stderr as JSON; cookie and token fields are masked. | info |
| DIAGNOSTICS | No | Save a screenshot on error (available via `check_session` as `last_error_screenshot`). | true |
| RETURN_MODE | No | Result mode: `both`, `image`, or `link`. | both |
| MCP_TRANSPORT | No | Transport to use: `http` or `stdio`. The `--stdio` argument also works. | http |
| BROWSER_LOCALE | No | Browser locale fingerprint. | en-US |
| MAX_STORAGE_MB | No | Library storage limit in MB. `0` disables the limit. | 2048 |
| MCP_AUTH_TOKEN | No | If set, requires `Authorization: Bearer` for /mcp. Not needed on Obot because Obot handles authentication. | |
| RETENTION_DAYS | No | Library cleanup retention in days. `0` disables the limit. | 14 |
| BROWSER_CHANNEL | No | Use a specific Chrome or Chromium channel. | |
| CHATGPT_CDP_URL | No | Connect to an existing Chrome instead of launching a browser. Remote addresses require ALLOW_REMOTE_CDP=true. | |
| PERSIST_SESSION | No | Persist refreshed cookies under /data. If the env value changes, the new value takes precedence. | true |
| PUBLIC_BASE_URL | No | Enables signed /files/<id> download links. | |
| ALLOW_REMOTE_CDP | No | Allow remote CDP addresses when connecting via CHATGPT_CDP_URL. | |
| ALLOW_URL_INPUTS | No | Allow downloading https image URLs. Private network addresses are always blocked. | true |
| BROWSER_TIMEZONE | No | Browser timezone fingerprint. | UTC |
| INLINE_MAX_BYTES | No | Total size limit for images returned inline. | 4 MiB |
| MAX_INPUT_IMAGES | No | Maximum number of input images. | 8 |
| MAX_QUEUE_LENGTH | No | Maximum number of queued jobs. | 20 |
| SYNC_WAIT_SECONDS | No | How long a tool call waits for a result before returning a job_id. Keep below 60 seconds for clients that time out tool calls at 60 seconds. | 45 |
| ALLOWED_INPUT_DIRS | No | Directories allowed for local file inputs. If empty, local files are not read. | |
| BROWSER_USER_AGENT | No | Browser user agent fingerprint. | |
| MAX_IMAGES_PER_JOB | No | Upper limit for the `count` parameter. | 4 |
| CHATGPT_DEFAULT_URL | No | URL where new conversations are opened, for example a ChatGPT Project or GPT. | https://chatgpt.com/ |
| CHATGPT_PROFILE_DIR | No | Use a persistent Chromium profile instead of an ephemeral browser context. | |
| MAX_CONCURRENT_JOBS | No | Number of concurrently running tabs (maximum 4). | 1 |
| BROWSER_PROXY_SERVER | No | Browser proxy server. | |
| CHATGPT_SESSION_STATE | No | Output from `npm run export-session`. Can be base64, plain JSON, a file path, or a cookie-extension JSON array. | |
| CHATGPT_SESSION_TOKEN | No | Value of the __Secure-next-auth.session-token cookie. Chunked cookies can be given as `part0|part1`; multiple cookies as `name=value; name2=value2`. | |
| MAX_INPUT_IMAGE_BYTES | No | Maximum size per input image. | 20 MiB |
| BROWSER_PROXY_PASSWORD | No | Browser proxy password. | |
| BROWSER_PROXY_USERNAME | No | Browser proxy username. | |
| CHATGPT_SELECTORS_JSON | No | Override ChatGPT UI selectors when the interface changes. See src/browser/selectors.ts for keys. | |
| BROWSER_EXECUTABLE_PATH | No | Path to a specific Chrome or Chromium executable. | |
| GENERATION_TIMEOUT_SECONDS | No | Maximum wait time for a single image generation. | 300 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues