Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_themesA

List all 24 shipped themes (boilerplate-dark, boilerplate-light, boilerplate, cupertino-dark, cupertino-light, cupertino, glass-dark, glass-light, glass, graphite-dark, graphite-light, graphite, press-dark, press-light, press, prism-dark, prism-light, prism, sketchbook-dark, sketchbook-light, sketchbook, terminal-dark, terminal-light, terminal). Eight families; each ships an unsuffixed parent carrying both modes via light-dark() plus pinned -light and -dark siblings (terminal is the exception — its unsuffixed file is dark-only). Every theme emits :root, :root[data-theme="<name>"], so ONE theme file dropped in as theme.css restyles the page with no markup change; the data-theme attribute is only required when several themes share a document (public/theme.css, the bundle).

get_themeA

Return one theme: declared token assignments, raw SCSS body, light-dark() support flag, and source path. Themes are authored through @mixin theme($name, $scheme: light dark, $standalone: true); $standalone: false drops the bare :root for multi-theme bundles. Never hand-write the selector.

search_themesC

Substring search across theme names, descriptions, and token values.

validate_themeA

Validate ANY theme CSS against cia's real token contract and WCAG contrast audit — the same check npm run validate-themes runs, exposed as a tool call. Not scoped to cia's own themes: works on a fully custom theme you (or another agent) just built, e.g. via the derive-theme assemble_prompt intent. Pass compiled CSS (a :root or [data-theme="..."] block) — this does not compile Sass, so give it the output, not .scss source. Returns missing required tokens (if any, mode "per-file" or "consolidated" depending on shape) and a11y warnings per contrast pair.

list_mixinsA

List all 157 public @mixins across core, layout, animation, icons, generator, per-component and recipe sources. Filter by category (core/layout/animation/icons/generator/component/recipe) or component name.

get_mixinA

Return one mixin: signature, parameter list, doc comment, full body, source path + line range.

search_mixinsB

Substring search across mixin names, signatures, docs, and bodies.

list_functionsB

List all 26 public @functions (color, space, radius, shadow, font-size, z, etc.). Same shape as list_mixins.

get_functionA

Return one function: signature, parameters, doc, body, source location.

search_functionsB

Substring search across function names, signatures, docs, and bodies.

list_tokensB

List the CSS custom-property tokens in the theme contract (scripts/theme-contract.json): 128 required + 40 optional = 168 total. Categories: a11y, action, brand, code, fx, ink, interactive, lines, misc, motion, radius, semantic, shadow, space, surface, type, z-index. Spacing note: the NUMBERED scale --space-0…--space-9 is required and is what components read (cia.space(4) → var(--space-4)); the t-shirt names --space-2xs/xs/sm/md/lg/xl are optional aliases the library emits as var() references. Theme the numbered step, not the alias. Radius note: --radius-avatar/badge/button/card/input/modal were removed (nothing read them). The working per-component knobs are --btn-radius, --card-radius, --input-radius, --modal-radius, --badge-radius, --tag-radius, each cascading from a generic radius (e.g. --btn-radius: var(--radius-md, 0.25rem)).

get_tokenA

Return one token: category, required flag, sample values across all themes, and the list of mixins/functions that reference it.

search_tokensC

Substring search across token names and categories.

list_animationsA

List the animation vocabulary (fade-in, slide-up, scale-in, pop, pulse, shimmer, spin, wiggle, …), the speed keys (fast/normal/slow), the animate-on effects (lift/glow/press/fade), and the mixin signatures.

get_animationA

Return one animation slug → keyframe mapping with usage examples, or the animate/animate-on mixin record by name.

list_componentsA

List every component file under scss/components/ (accordion, buttons, copy-button, data, feedback, forms, navigation, overlay, stepper, tabs).

get_componentA

Return one component: description, all its public mixins (signature + summary + body), and the source path.

search_componentsC

Substring search across component names, descriptions, and their mixin names/signatures/docs/bodies.

list_recipesA

List recipes from scss/recipes/. Two kinds: markdown pattern recipes (kind:"md" — dialog, combobox, print-to-pdf: a pattern to follow in any framework, with category + complexity) and opt-in SCSS recipes (kind:"scss" — e.g. bare-tags, consumed via @use).

get_recipeA

Return one recipe: name, kind ("md" pattern recipe or "scss" import), category/complexity, usage, and full body (markdown for md recipes, SCSS for scss recipes).

read_llm_txtA

Return llm.txt — the canonical single-fetch summary for AI agents.

read_changelogA

Return CHANGELOG.md — full release history including breaking-change notes.

read_migrationA

Return MIGRATION.md — v0.7 → v0.8 migration guide (renames, removed features, breaking changes).

read_themingA

Return THEMING.md — theme authoring + override patterns.

read_agentsA

Return AGENTS.md — entry point for AI coding agents (rules, tiers, quick decisions).

read_contractA

Return CONTRACT.md — human-readable token contract.

read_three_tiersA

Return THREE-TIERS.md — the three authoring tiers (mixin / utility class / bare tag).

read_readmeA

Return README.md — top-level install + usage.

read_versioningA

Return VERSIONING.md — semver policy, deprecation lifecycle, and the Conventional Commits to changelog mapping.

assemble_promptA

Build a ready-to-paste context block for an LLM consuming cia. Intent picks the slice: "overview" | "mixin:" | "component:" | "theme:" | "tokens" | "animations" | "recipe:".

resolve_sizeA

Snap a design px value to cia's 4px geometric grid. Returns the step number, the SCSS call to emit (cia.grid(n) when exactly on grid; cia.px(value) when off-grid), the equivalent rem, and a human-readable note. AI agents: call this whenever you get a px value from a design tool (Figma, mockup, screenshot) and need to express it in cia code. NEVER write raw rem/px literals when a cia function applies. See /docs/composition for the full decision tree.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 31 tools

Disambiguation4/5

The list_/get_/search_ pattern per resource (components, themes, tokens, functions, mixins, recipes, animations) gives each tool a clear resource+action target. Minor overlap exists where get_animation also returns a mixin record (blurring with get_mixin) and where read_llm_txt/read_contract/read_readme all return summary-style docs, but descriptions disambiguate these well.

Naming Consistency5/5

Nearly every tool follows a clean snake_case verb_noun convention (list_themes, get_theme, search_themes, validate_theme, assemble_prompt). The read_* prefix is applied uniformly across all nine doc tools, forming a coherent sub-convention rather than an inconsistency.

Tool Count3/5

31 tools is heavy and pushes past the 25-tool threshold where sets start feeling unwieldy. The breadth of the CSS library justifies many of them, but the nine individual read_* doc tools and parallel list/get/search triples for seven resource types could be consolidated (e.g. a single read_doc(name) tool).

Completeness4/5

Coverage is strong: list/get/search exist for components, themes, tokens, functions, and mixins, plus validation, size resolution, and prompt assembly. Minor gaps remain — animations and recipes have list/get but no search counterpart, and there is no create/update surface, though that fits a read-oriented reference server.

Maintenance

ActivityMaintained
ResponsivenessNo issues