fontsource-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fontsource-mcp find a variable sans-serif font and get the CSS"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: fuzzyqueryover id and family, plus AND filters (category,subsets,weights,styles,variable,license,type, andaxessuch as["wdth","opsz"]).sortispopular,trending, ornewest. Paginated. Rows carry enough to pick a font, plus Google Fontspopularityanddesigners.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 oneid.get_font_css: stylesheeturlsfor<link>or@import, apreloadlink for the first latin woff2, npm install and import lines, thefont-familyrule, and inlinable@font-faceCSS with absolute URLs.variable:trueselects the variable package.download_font: writes to<dest>/<id>/. Filters by subset, weight, style, andformat(woff2, woff, ttf).variable:truefetches<subset>-wght-<style>.woff2; a CJK subset such asjapanesefetches its numbered slices.zip:truesaves the official zip unextracted.index_fonts: facet counts by category, subset, license, type, and variable. WithoutFileit writes the full catalog JSON to disk.get_axis_registry: the variable-font axis registry.check_text: the characters of atextthat a font's unicode-range subsets miss, and the subset keys the text needs.compare_fonts: writes one HTML specimen of severalidsat 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-mcpThe 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 secondsA 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>.csshttps://fonts.google.com/metadata/fontsfor popularity, trending, date added, designers, and axes. It is undocumented; if it fails,search_fontsreturns plain rows with awarning.
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 toolsdownload_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_registryARead-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_fontARead-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_cssARead-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_fontsARead-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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Find free, openly licensed fonts by style, use or language, and get the CSS to use them.
Discover, inspect, convert, optimize, and work with fonts using EverythingFonts tools.
320K+ open-source SVG icons: 12 tools, anonymous metadata search; SVG, exports, collections via Pro.
Icons for agentic development: search & fetch 366,000+ open-source icons as SVG/PNG. No API key.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for searching Google Fonts and generating complete CSS/Tailwind typographic systems with font pairings and modular scales.5149 PyPI24MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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.2MIT
- AlicenseAqualityCmaintenanceThis 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.469 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT