Skip to main content
Glama
fontsource-mcp

fontsource-mcp

fontsource-mcp

An MCP stdio server for https://fontsource.org, which packages 2000+ open-source fonts (all of Google Fonts plus extras) as npm modules served from the jsDelivr CDN. It reads the public API and CDN and needs no key.

A subset is a font file cut down to one script, such as latin. A variable font packs a whole weight range into one file and exposes axes such as wght.

Tools

  • search_fonts: fuzzy query over id and family, plus AND filters (category, subsets, weights, styles, variable, license, type, and axes such as ["wdth","opsz"]). sort is popular, trending, or newest. Paginated. Rows carry enough to pick a font, plus Google Fonts popularity and designers.

  • get_font: subsets, weights, styles, axes, unicode ranges, license, version, npm names, CSS font-family names, page URL, zip URL, and CDN URL templates for one id.

  • get_font_css: stylesheet urls for <link> or @import, a preload link for the first latin woff2, npm install and import lines, the font-family rule, and inlinable @font-face CSS with absolute URLs. variable:true selects the variable package.

  • download_font: writes to <dest>/<id>/. Filters by subset, weight, style, and format (woff2, woff, ttf). variable:true fetches <subset>-wght-<style>.woff2; a CJK subset such as japanese fetches its numbered slices. zip:true saves the official zip unextracted.

  • index_fonts: facet counts by category, subset, license, type, and variable. With outFile it writes the full catalog JSON to disk.

  • get_axis_registry: the variable-font axis registry.

  • check_text: the characters of a text that a font's unicode-range subsets miss, and the subset keys the text needs.

  • compare_fonts: writes one HTML specimen of several ids at each weight and at 16, 24, and 48px, for a browser screenshot.

Related MCP server: figma-fonts

Download location

download_font writes under dest when given, else FONTSOURCE_DOWNLOAD_DIR, else ./fonts in the server's working directory. Under a plugin install that directory is not your project, so set the variable or pass dest. In Claude Code, export it before launching claude. The Claude Desktop extension asks for a folder at install.

Install

Claude Code:

/plugin marketplace add Nightious-Tools/fontsource-mcp
/plugin install fontsource-mcp@fontsource-mcp

The plugin wires the server through ${CLAUDE_PLUGIN_ROOT} and adds a skill for agents. Needs Node 18+.

Claude Desktop: download fontsource-mcp.mcpb from Releases and open it. The server is one dependency-free dist/index.mjs, so nothing runs npm install.

Manual: run npm install && npm run build, then add to claude_desktop_config.json:

"fontsource": {
  "command": "node",
  "args": ["C:\\path\\to\\fontsource-mcp\\dist\\index.mjs"],
  "env": { "FONTSOURCE_DOWNLOAD_DIR": "C:\\Users\\you\\fonts" }
}

The MSIX build of Claude Desktop keeps that file under %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\.

Build and test

dist/index.mjs is the shipped artifact and is committed. After any change under src/, rebuild and commit it.

npm run build       # dist/index.mjs
npm run pack        # build, then fontsource-mcp.mcpb
npm run selftest    # about 150 live requests, ten to twenty seconds

A selftest failure means the API shape or CDN file naming changed.

Data sources

  • https://api.fontsource.org/v1/{fonts, fonts/:id, variable/:id, axis-registry, download/:id}

  • https://cdn.jsdelivr.net/fontsource/fonts/:id[:vf]@latest/<subset>-<weight|axis>-<style>.<ext>

  • https://cdn.jsdelivr.net/npm/@fontsource[-variable]/:id@latest/<file>.css

  • https://fonts.google.com/metadata/fonts for popularity, trending, date added, designers, and axes. It is undocumented; if it fails, search_fonts returns plain rows with a warning.

Each font carries its own license (OFL, Apache-2.0, CC0, and others) in the license field.

License

Source-available, not open source. You may install and run it; you may not redistribute or modify it. See LICENSE.

Available Tools

6 tools
download_fontA

Download font files to disk under //. Default dest is $FONTSOURCE_DOWNLOAD_DIR, else ./fonts (currently /app/fonts). Static mode filters subsets, weights, styles, and format. variable:true fetches --.woff2 variable files and ignores weights and format. zip:true saves the official all-files zip without extracting it. Returns saved names and bytes.

Inputs: id (required), zip, axis, dest, +5 more.

get_axis_registryA
Read-only

Variable-font axis registry: name, description, min, max, and default for every axis tag (wght, wdth, opsz, slnt, ital, GRAD, and the rest). Pass a tag for one entry.

Inputs: tag.

get_fontA
Read-only

Metadata for one font: subsets, weights, styles, variable axes, unicode ranges, license, npm package names, CSS font-family names, fontsource.org page, zip URL, and CDN URL templates for every file. Call it before get_font_css or download_font to learn which subsets and weights exist.

Inputs: id (required).

get_font_cssA
Read-only

Font embedding snippets: CDN tags, @import lines, npm install and import lines, the font-family rule, and the @font-face CSS text with absolute URLs, safe to inline. Defaults to weight 400 normal. Each extra weight and style combination adds about 1.5KB of CSS. Set variable:true for the variable package; the font-family then becomes " Variable".

Inputs: id (required), styles, subsets, weights, +2 more.

index_fontsA

Catalog facets: counts per category, subset, license, type, and variable or static. With outFile it also writes the full 2000+ font catalog JSON (id, family, subsets, weights, styles, category, license, type, variable) to that path so you can grep or jq it locally instead of paginating search_fonts.

Inputs: outFile.

search_fontsA
Read-only

Search the Fontsource catalog of 2000+ open-source fonts. The fuzzy query matches id and family (exact, then prefix, then substring, then all words). Filters are AND. Rows are compact and carry the id every other tool needs. Filters without a query browse a category.

Inputs: type, limit, query, offset, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a clearly distinct part of the workflow: search_fonts finds fonts, get_font provides metadata, get_font_css generates CSS, download_font downloads files, index_fonts provides catalog-level facets/dumps, and get_axis_registry covers variable-axis definitions. Even the catalog-level pair search_fonts/index_fonts is separated by search results versus facet counts and full dumps.

    Naming Consistency5/5

    All tools follow a consistent verb_object snake_case convention: search_fonts, get_font, get_font_css, download_font, index_fonts, get_axis_registry. The pluralization varies only where semantically appropriate, and there is no mixing of styles or vague generic verbs.

    Tool Count5/5

    Six tools is well-scoped for a font catalog server: search, metadata, CSS generation, file download, catalog indexing, and axis registry each cover a distinct need. No tool feels redundant or missing from the core surface.

    Completeness5/5

    The tool set covers the full read-only font catalog workflow: discovering fonts, inspecting available subsets/weights/styles, generating embeddable CSS, downloading files, exporting the full catalog, and understanding variable-font axes. There are no obvious dead ends; get_font informs get_font_css and download_font, and index_fonts handles bulk catalog access.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server for searching Google Fonts and generating complete CSS/Tailwind typographic systems with font pairings and modular scales.
      5
      149 PyPI
      24
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to access locally installed fonts and control Figma text through a local bridge, including listing, auditing, replacing, and setting fonts on text nodes.
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      This MCP server enables AI assistants to search the Google Fonts catalogue, retrieve detailed font metadata, generate live HTML text previews, and obtain embed code for use on web pages.
      4
      69 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to discover, inspect, compare, and resolve local fonts and typography through bounded search, paging, family inspection, exact assets, contextual compositions, and preview images, while keeping fonts and model inference local.
      1
      MIT