backgrounds

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• list_backgrounds

  Browse the catalog of background structures. Optionally filter by a free-text query, tag or mood word. Returns name, one-line summary, mood, use cases and a preview URL for each.

• suggest_backgrounds

  Rank structures for a natural-language brief ("dark aurora glow for an AI landing page"). Returns why each matched, matching built-in palettes, and a ready-to-run example request for generate_backgrou

• describe_background

  Full style card for one structure: what it looks like, mood, where text can go, tips, and every parameter it honours with ranges, defaults and the visual effect of low/high values. Also returns the JS

• list_palettes

  Built-in curated colour palettes with their hex colours and derived mood tags (dark, pastel, vivid, warm, cool…). Pass the id as palette.palette to generate_background.

• list_brand_kits

  Saved brand palettes on this account. Pass a kit's slug as `brand` to generate_background to render on-brand without repeating hex colours.

• generate_background

  Render a background as SVG or PNG. Deterministic: the same structure, options and seed always give the same image, so store the returned seed. Returns a permanent, cacheable image URL you can use dire