Overview
/catalog.json is built with the site and served as a static file. It carries every catalog entry, checked against the same schema the site uses, so a reader can trust the shape.
| Field | Type | Meaning |
|---|---|---|
version | 1 | The feed's format. We raise it when the shape changes in a way that would break an existing reader, so check it first. |
count | number | How many entries there are. It always equals the length of entries. |
entries | array | Every catalog entry. |
The response is cacheable for an hour (cache-control: max-age=3600), so a change can take up to an hour to reach a client that cached it.
An entry
| Field | Meaning |
|---|---|
id | A kebab-case identifier, the same one used in URLs such as /catalog/<id>. |
name | The display name. |
category | One of design-tool, whiteboard, agent, code, ui-library, motion, 3d, asset, planning, inspiration, utility. |
url | The tool's home page. |
docsUrl | Its documentation, when it has a separate one. Optional. |
description | One or two sentences, written by ExonUI. |
pricing | free, open-source, freemium or paid. |
platforms | Any of macos, windows, linux and web. |
tags | Search words. |
verifiedAt | The date (YYYY-MM-DD) we last checked the entry. Optional. |
setupNotes | Things a person should know before setting it up. Optional. |
tryPrompt | A first request to try once it's connected. Optional. |
pack | What ExonUI can act on. See below. |
The pack
| Field | Meaning |
|---|---|
kind | One of mcp, library, asset, skill, bridge, link. See how ExonUI fits together. |
transport | For servers: how to reach it. type is stdio, local-http, remote or direct-only. |
healthCheck | For local servers: how to tell it's running. type is port, command or http. Optional. |
classification | official, community-vetted or unverified. |
defaultPolicy | What Grid does with the pack's write tools by default: read, ask or write. |
readOnlyTools | Tools known to be read-only, for servers that don't say so themselves. |
install | For libraries: the install command. Optional. |
notesId | The id of the pack's Grid Note, when it has one. Optional. |
No secrets in the feed
Where a server needs a token, the feed names the environment variable and never holds a value.
A real entry
This is the entry for Lenis, as the feed serves it:
{
"id": "lenis",
"name": "Lenis",
"category": "motion",
"url": "https://lenis.darkroom.engineering",
"docsUrl": "https://github.com/darkroomengineering/lenis",
"description": "Lightweight smooth-scroll library that keeps native scrolling behaviour. Pairs well with GSAP ScrollTrigger and scroll-linked animations.",
"pricing": "open-source",
"platforms": [
"macos",
"windows",
"linux",
"web"
],
"tags": [
"scroll",
"smooth-scroll",
"animation"
],
"verifiedAt": "2026-11-16",
"pack": {
"kind": "library",
"classification": "official",
"defaultPolicy": "read",
"readOnlyTools": [],
"install": "npm install lenis",
"notesId": "lenis"
}
}Reading it
// ORIGIN is the site you're reading from, for example the origin of this page.
const response = await fetch(new URL("/catalog.json", ORIGIN));
const feed = await response.json();
if (feed.version !== 1) throw new Error(`Unsupported catalog feed version ${feed.version}`);
if (feed.count !== feed.entries.length) throw new Error("Incomplete catalog feed");
const libraries = feed.entries.filter((entry) => entry.pack.kind === "library");Read the fields you need and ignore the rest, so a field added later doesn't break you.
Fonts feed (/api/fonts)
/api/fonts serves a cached list of open-source Google Fonts (sourced from Fontsource without requiring an API key on the client). Grid and the CLI use it to search families, weights, subsets and variable font support.
| Parameter | Meaning |
|---|---|
q | Case-insensitive search by font family or slug (?q=inter). Exact and prefix matches rank first. |
category | One of sans-serif, serif, display, handwriting, monospace, icons. |
subset | Filter by character subset such as latin, cyrillic or vietnamese. |
variable | true or false to filter variable fonts. |
limit | Maximum items per page (1–2000, default 50). |
offset | Zero-based pagination offset (0–5000, default 0). |
The upstream directory is cached for 24 hours (stale-while-revalidate up to 7 days), with a compact fallback list of popular open-source fonts if the upstream API is temporarily unreachable.