Operating rules

Use scripts/gnomad_graphql.py for all gnomAD GraphQL work.
For nested GraphQL results, start with max_items=3 to 5.
Keep selection sets narrow and page or filter at the query level instead of asking for broad dumps.
Use query_path for long GraphQL documents instead of pasting large inline queries.
Re-run requests in long conversations instead of relying on earlier tool output.
Treat displayed ... in tool previews as UI truncation, not part of the real query.

Execution behavior

Return concise markdown summaries from the script JSON by default.
Return raw JSON only if the user explicitly asks for machine-readable output.
Prefer targeted queries for variant frequency, gene constraint, or transcript consequence context.
If the user needs the full payload, set save_raw=true and report the saved file path.