Globestudio

io.github.alevizioPublished by GitHub account aleviziov0.2.6Updated Nov 11, 2026

Generate dotted-globe maps, share URLs, and embed snippets from chat.

VerifiedStreamable HTTPWeb executableDeveloper ToolsMedia & Design

Overview

AI-generated overview

Builds dotted-globe map visuals from chat: browse look presets, generate share and embed URLs, and get paste-ready embed code.

What you can do
  • List and fuzzy-find look presets by style or vibe keyword, with ids, tags and thumbnails
  • Build customized globe share URLs and bare embed URLs from a preset or an existing link
  • Decode a pasted Globestudio link into its look and settings so it can be modified
  • Generate embed code as iframe HTML, a React component or a script-tag loader
  • Get the canonical live embed URL and PNG thumbnail URL for a single preset
When to use it
Useful when you want an assistant to produce a dotted-globe or map visual, tweak an existing Globestudio link, or hand you embed code for a site or app without opening the studio manually.
Requirements
Either the hosted remote endpoint over streamable HTTP, or the npm package run locally with npx (Node.js). No account, API key or environment variable is needed; the preset catalog ships with the package.
Before you install
Tools only build or read links and store nothing, so no data is written or deleted. The hosted version logs request metadata such as IP address and path for up to 30 days; running locally sends nothing anywhere. Tool arguments, including any link you paste, are sent to the host when using the remote endpoint.

Installation

In SourceWeft

  1. Open Globestudio in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.alevizio%2Fglobestudio/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "globestudio": {
      "type": "http",
      "url": "https://globestudio.app/mcp"
    }
  }
}

README

@globestudio/mcp

Model Context Protocol server for Globestudio. It lets an MCP-compatible AI assistant make dotted-globe maps, build share URLs and get embed snippets from chat.

Connect by URL (no install)

Globestudio hosts this server at https://globestudio.app/mcp (streamable HTTP). You don't need to install anything, and there is no account or API key.

Claude Code

bash
claude mcp add --transport http globestudio https://globestudio.app/mcp

Claude (claude.ai and Claude Desktop): Open in Claude's connector directory. Or open Customize, then Connectors, click +, then Add custom connector. Paste https://globestudio.app/mcp and click Add. Custom connectors work on Free (one connector), Pro, Max, Team and Enterprise plans; on Team and Enterprise an Owner adds it first.

ChatGPT: Open in ChatGPT and press Install plugin. The plugin brings the tools and the Globestudio skill.

Codex

bash
codex mcp add globestudio --url https://globestudio.app/mcp

Or add it to ~/.codex/config.toml:

toml
[mcp_servers.globestudio]url = "https://globestudio.app/mcp"

Cursor: add it to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):

json
{  "mcpServers": {    "globestudio": {      "url": "https://globestudio.app/mcp"    }  }}

Or install it in one click by opening this link:

text
cursor://anysphere.cursor-deeplink/mcp/install?name=globestudio&config=eyJ1cmwiOiJodHRwczovL2dsb2Jlc3R1ZGlvLmFwcC9tY3AifQ==

Any other MCP client: add https://globestudio.app/mcp as a remote server using the streamable HTTP transport.

The hosted server is stateless: every request gets a fresh server, nothing is stored between requests, and replies are plain JSON. It takes POST only (GET and DELETE answer 405), requests up to 128 KB and batches of up to 10 messages.

Run it locally (stdio)

For Claude Code:

bash
claude mcp add globestudio -- npx -y @globestudio/mcp

For Claude Desktop, add this to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "globestudio": {      "command": "npx",      "args": ["-y", "@globestudio/mcp"]    }  }}

For Cursor, Cody, Continue or any other MCP-over-stdio client: point it at npx -y @globestudio/mcp the same way.

Restart your AI tool. Globestudio tools should now appear in its tool catalog.

What it does

Six tools. None of them call an external API, because the preset catalog ships inside the package:

ToolPurpose
list_presetsEvery shipped look: id, name, blurb, vibe tags, thumbnail URL, embed URL.
find_presets({ vibe })Find looks by a style word or a short phrase. synthwave → Vapor; print → Halftone / Risograph / Newsprint; glow → Aurora / Bloom; retro print → Halftone first.
build_share_url({ look?, share_url?, selection?, dotColor?, ..., config? })Build globe URLs: a studio share URL and an /embed URL. Start from a look, or pass a link as share_url and only the settings to change; everything else in the link is kept. config: { viewSwitch: true } gives the embed a Globe and Map switch.
read_share_url({ url })Decode a Globestudio link (studio share link, /looks/<id> link or /embed URL) into its look and settings, so an assistant can change a link you paste.
embed_snippet({ look, framework })Paste-ready code: iframe HTML, react component, or script-tag loader.
preview_url({ look })The canonical live /embed URL and a PNG thumbnail URL for one preset.

Each tool has a short title, such as Find looks by style, and is marked read-only, not destructive and closed world, since it only builds or reads links. ChatGPT treats a tool without the read-only mark as a write action and asks the user to confirm it.

Example prompts

"Show me every Globestudio preset with a retro vibe."

"Make me a clean dotted globe with cyan dots and give me a share URL."

"Generate the React component for the Vapor preset at 1200×600."

"Here is my globe: https://globestudio.app/?c=… Make the dots red and show only Europe."

Privacy

The hosted server reads only the arguments of each tool call, such as a look id, a style word, a color, a region or a Globestudio link. It answers from those and its built-in list of looks, and keeps nothing: no storage, no accounts, no cookies and no calls to any other service. It never sees the rest of your conversation. Vercel, which hosts it, sees each request's IP address, as any web host does, and keeps a request log for up to 30 days with the time, IP address, path, status, user agent and region of each request, not the tool arguments. Run locally with npx -y @globestudio/mcp, the server sends nothing anywhere. The full policy is at globestudio.app/privacy, and the terms of use at globestudio.app/terms.

Troubleshooting

  • The tools don't show up. Check that the URL is exactly https://globestudio.app/mcp and that the client uses streamable HTTP (in Claude Code, --transport http). Opening the URL in a browser shows "Method not allowed". That is expected: the endpoint takes POST only.
  • "Unknown preset". Ask for the list of looks (list_presets) and use one of the ids it returns.
  • "is not a URL". read_share_url and share_url take a full Globestudio link: a studio link with ?c=, a /looks/<id> link or an /embed URL.
  • "Request body is larger than 128 KB" or "A batch can hold up to 10 messages". The request was too big. Send fewer settings, or one call at a time.
  • Anything else. Open an issue on GitHub.

Source

This package is part of the Globestudio monorepo. The preset catalog mirrors src/data/look-presets.js from the main app. New presets are added here in the same release.

License

MIT. See LICENSE.

Source: packages/mcp/README.md at commit 67ee903

Tools

6

list_presets

List looks

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

Takes no parameters.

find_presets

Find looks by style

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.

Parametersviberequired

build_share_url

Build a share link

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).

ParameterslookshapeconfigdensitydotColorselectionshare_urlbackground

read_share_url

Read a share link

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.

Parametersurlrequired

embed_snippet

Get embed code

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).

Parameterslookrequiredwidthheightframework

preview_url

Get a look's preview links

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.

Parameterslookrequired

Version history

6
  1. v0.2.6LatestNov 11, 2026
  2. v0.2.5Oct 18, 2026
  3. v0.2.4Oct 6, 2026
  4. v0.2.3Oct 5, 2026
  5. v0.2.1Oct 3, 2026
  6. v0.2.0Sep 28, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts