Globestudio

List every Globestudio look preset — id, name, blurb, vibe tags, thumbnail URL, embed URL. Call this first when the user asks about available looks.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Fuzzy-find presets by vibe / aesthetic / use-case keyword. Examples: 'synthwave' → Vapor; 'print' → Halftone, Risograph, Newsprint; 'retro' → CRT, BadTV, Pixel; 'glow' → Aurora, Bloom. Returns ranked matches.

{
  "type": "object",
  "properties": {
    "vibe": {
      "type": "string",
      "description": "Vibe keyword. Single word or short phrase."
    }
  },
  "required": [
    "vibe"
  ],
  "additionalProperties": false
}

Build Globestudio URLs for a customized globe. Start from a preset (look) or change an existing link (share_url, e.g. one the user pasted): pass only the settings to change and everything else in the link is kept. Returns share_url (opens the studio with those settings) and embed_url (the bare canvas, for iframes).

{
  "type": "object",
  "properties": {
    "look": {
      "type": "string",
      "description": "Preset id, e.g. 'halftone'. Required unless share_url is given."
    },
    "share_url": {
      "type": "string",
      "description": "A Globestudio link to change instead of starting from a preset."
    },
    "selection": {
      "type": "string",
      "description": "Region: 'world' (default), ISO country code ('JP' or 'JPN'), country name ('Japan'), continent ('Europe'), or subregion ('Western Europe')."
    },
    "dotColor": {
      "type": "string",
      "description": "Hex color, e.g. '#3df4ff'.",
      "pattern": "^#[0-9a-fA-F]{6}$"
    },
    "background": {
      "type": "string",
      "description": "Background hex.",
      "pattern": "^#[0-9a-fA-F]{6}$"
    },
    "density": {
      "type": "integer",
      "minimum": 10,
      "maximum": 100
    },
    "shape": {
      "type": "string",
      "enum": [
        "Circle",
        "Hexagon",
        "Triangle",
        "Pentagon",
        "Square",
        "Voxel",
        "Particle Grid",
        "Diamond",
        "Star",
        "Plus",
        "Ring",
        "ASCII"
      ]
    },
    "config": {
      "type": "object",
      "description": "Any other setting, using the keys read_share_url returns in config, e.g. {\"viewMode\": \"flat\"} or {\"globeSettings\": {\"autoSpin\": false}}. Nested settings merge key by key; keys Globestudio does not accept come back in ignored.",
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}

Decode a Globestudio link (a studio share link, a /looks/<id> link or an /embed URL) into the look and settings it carries. Use it when the user pastes a link, then pass the link as share_url to build_share_url with the changes they ask for.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The Globestudio link, e.g. 'https://globestudio.app/?c=…'."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Generate paste-ready embed code for any preset. Choose 'iframe' (HTML for Webflow / Notion / WordPress), 'react' (drop-in component), or 'script-tag' (vanilla JS loader).

{
  "type": "object",
  "properties": {
    "look": {
      "type": "string",
      "description": "Preset id."
    },
    "framework": {
      "type": "string",
      "enum": [
        "iframe",
        "react",
        "script-tag"
      ],
      "default": "iframe"
    },
    "width": {
      "description": "Number of pixels OR string like '100%'."
    },
    "height": {
      "description": "Number of pixels OR string."
    }
  },
  "required": [
    "look"
  ],
  "additionalProperties": false
}

Get the canonical live embed URL + thumbnail PNG URL for a single preset. Useful when you want to render an inline preview without building a full share URL.

{
  "type": "object",
  "properties": {
    "look": {
      "type": "string",
      "description": "Preset id."
    }
  },
  "required": [
    "look"
  ],
  "additionalProperties": false
}