Freegma

Copy an image from a public http(s) link into the project. The server downloads it once, converts it to WebP (at most 2560 px per side) and returns its path relative to the frames: use it as <img src="assets/….webp"> or url(assets/….webp). Prefer this over linking images from other sites (links break or get blocked) and never embed images as base64. JPEG, PNG, WebP, GIF or AVIF, up to 10 MB. SVG is not accepted: write it inline in the frame. get_project_context lists the images already in the project (images), including the ones the person uploaded in the studio, with their file name. Images that no project file uses are removed after about two weeks. Give url, or, for a file you have locally, upload (from get_image_upload_url, after sending the file).

add_image

Drop named token variants into the project's suggestions drawer for one-click preview.

add_suggestion

Build a project as a static website and get a download link for it as a .zip, ready to upload as is to any static host (Netlify Drop, Cloudflare Pages, Vercel, GitHub Pages): one page per frame, DESIGN.md tokens inlined, Freegma URLs made relative, fonts and images copied in, project docs left out. The index frame is also written as index.html. Links between pages should be relative (href="pricing.html"). Returns the pages and any warnings now; the link is for the person, works without logging in, expires in 24 hours, and builds the zip when opened.

build_site

Create a project seeded with PROJECT.md, DESIGN.md, FEEL.md, shared.css and a design-reference frame.

create_project

Remove a frame from the canvas. The HTML file is kept unless delete_file is true.

delete_frame

Get a download link for a .freegma.zip backup of one project (or of every project when project is omitted), with its images and the fonts its DESIGN.md uses. The link is for the person: give it to them as is. It works without logging in, expires in 24 hours, and the zip is built when the link is opened, with the project as it is then.

export_project

Get a permanent public link to one of the project images, to use outside Freegma: a live site, an email, an app. The link opens only the image (a copy of it), never the project frames, and is not removed by the cleanup of unused images. Calling it again returns the same link; the person can turn it off in the studio (Images panel). Only when the person needs the image outside Freegma: inside frames keep using the assets/….webp path, and build_site already copies the images into the site.

get_image_public_url

For an image file you have locally and no public link to: get a presigned URL to send it straight to the Freegma storage. Send the raw file with PUT to upload_url within 15 minutes (e.g. curl -X PUT -T photo.png "<upload_url>"), exactly `bytes` long, no multipart and no extra headers; then call add_image with project and upload to add it to the project. Same limits as add_image: JPEG, PNG, WebP, GIF or AVIF, up to 10 MB, and the project and account space. Needs a shell or HTTP client that can send files; with a public link, use add_image with url instead.

get_image_upload_url

PROJECT.md, DESIGN.md and FEEL.md contents; the frames with their url (renders with tokens and fonts) and canvas layout; the CSS variables generated from the DESIGN.md tokens (design.tokensCss); pending suggestions; the project images; and guide, the quality bar every frame must meet (read it before write_frame).

get_project_context

Full instructions of a Freegma skill, adapted for MCP. Same text as the prompt of that name.

get_skill