Search the web or research a topic using ChatGPT.

Provide either query or prompt_file. The prompt is sent directly to ChatGPT.

Args: query: Full prompt to send to ChatGPT. prompt_file: Path to a text file containing the prompt. Relative paths resolve from the MCP server process working directory. output_file: Optional path where the cleaned markdown response should be saved. Parent directories are created if needed. return_output: When True, return the full response to the MCP client. When False, return only a short saved-path summary. Defaults to True unless output_file is provided, in which case it defaults to False to keep client context light. output_json: When True, try to parse/repair the response as JSON after ChatGPT returns. If output_file is provided, raw output is saved first and overwritten only when JSON post-processing succeeds. If post-processing fails, raw output is left in place.

Run multiple ChatGPT search/research prompts concurrently.

Each request opens its own ChatGPT tab and runs concurrently with the others. This is the text equivalent of gpt_image_gen_batch. The server runs at most 3 ChatGPT tabs at a time across all calls and sessions; larger batches queue internally.

Each item in requests is a dict with keys:

• query (optional, str): the full prompt

• prompt_file (optional, str): path to a text file containing the prompt

• output_file (optional, str): path where the cleaned markdown response should be saved

• label (optional, str): heading used for this item in the combined response; defaults to output_file, then prompt_file, then request_<n>

• return_output (optional, bool): overrides the batch-level return_output for this item

• output_json (optional, bool): overrides the batch-level output_json for this item

Provide either query or prompt_file for each item. Relative file paths resolve from the MCP server process working directory.

return_output is batch-level unless overridden per item. When omitted, each item defaults to returning the full output only if it has no output_file. output_json is batch-level unless overridden per item. When enabled, the response is parsed/repaired after ChatGPT returns. For file outputs, raw output is saved first and overwritten only when JSON post-processing succeeds.

Returns a markdown summary. If outputs are returned, they are grouped under per-request headings.

Generate one or more images via ChatGPT image gen and save them to disk.

The prompt is sent directly to ChatGPT — phrase it as an image-generation request and let the prompt itself specify how many images you want.

For running multiple distinct prompts in parallel, use gpt_image_gen_batch instead — it fans out concurrently inside a single MCP call. Issuing two gpt_image_gen calls from one Claude message executes serially because the MCP harness serializes calls to the same server.

Args: prompt: Full image-gen prompt sent directly to ChatGPT. filename_prefix: Stem for saved files. Single image saves as <prefix>.<ext>; multiple images get numbered suffixes (<prefix>-1.<ext>, <prefix>-2.<ext>, ...). Defaults to a hash of the prompt. save_dir: Where to save images. Defaults to <cwd>/generated/ (created if missing). embed_images: When True, the saved images are returned in the tool response so Claude can analyze them. Set False during long iteration loops to keep context light — paths are still returned.

Returns a list of MCP content blocks: a text summary plus, if embed_images is True, the image blobs.

Run multiple image-gen prompts in parallel via ChatGPT image gen.

Each request opens its own ChatGPT tab and runs concurrently with the others. This is how you actually parallelize image gen — issuing multiple separate gpt_image_gen tool calls from a single Claude message gets serialized by the MCP harness, but a single gpt_image_gen_batch call fans out internally and bypasses that.

Each item in requests is a dict with keys:

• prompt (required, str): the full image-gen prompt

• filename_prefix (optional, str): stem for saved files; falls back to a hash of the prompt

• save_dir (optional, str): override save location for this item; defaults to <cwd>/generated/

embed_images is batch-level — applies to all items. Set False during long iteration loops to keep Claude's context light.

All items run concurrently, capped at 3 ChatGPT tabs at a time server-wide; larger batches queue internally. If one fails, the others still complete; failed items show up in the response as [<prefix>] FAILED: <error>.

Account-level rate limits may still apply under sustained concurrency.

Returns a list of MCP content blocks: per-item text summaries plus, if embed_images is True, the image blobs in order.