Skip to content
Back to search

fontetto

MarketplaceWorks with Claude CodeGitHub

Fonts for design agents: search dafont by style and licence, preview with your copy, install with @font-face CSS. Skill, CLI, MCP server.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bit-trading-company--fontetto/badge.svg)](/listings/bit-trading-company--fontetto)

HTML

<a href="/listings/bit-trading-company--fontetto"><img src="/api/listings/bit-trading-company--fontetto/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code (plugin with the skill)** — runs straight from source on Node ≥ 22.18, nothing to build:

/plugin marketplace add Bit-Trading-Company/fontetto
/plugin install fontetto@fontetto

**CLI**

npm install -g github:Bit-Trading-Company/fontetto

**MCP server** (Claude Desktop, Cursor, any MCP client)

claude mcp add fontetto -- npx -y github:Bit-Trading-Company/fontetto mcp
{ "mcpServers": { "fontetto": { "command": "npx", "args": ["-y", "github:Bit-Trading-Company/fontetto", "mcp"] } } }

Tools: `search_fonts` (`any` for several words), `font_info` (`files` for case/scripts/digits), `preview_fonts` (returns one contact-sheet image), `get_font`, `list_categories`, `tag_font`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines
  1. {
  2. "name": "fontetto",
  3. "owner": {
  4. "name": "Bit Trading Company",
  5. "url": "https://bit-trading-company.com"
  6. },
  7. "metadata": {
  8. "description": "Fonts for design agents: find, preview, licence-check and install fonts from dafont."
  9. },
  10. "plugins": [
  11. {
  12. "name": "fontetto",
  13. "source": "./",
  14. "description": "Find, preview and install custom fonts (dafont) with licence checks and @font-face CSS — as a skill.",
  15. "version": "0.1.0",
  16. "category": "design",
  17. "keywords": ["fonts", "typography", "dafont", "font-face", "design"]
  18. }
  19. ]
  20. }
README.md · README · 196 lines
  1. # fontetto
  2. **Fonts for design agents.** Search third-party font providers by style and licence, look at candidates
  3. rendered with your own copy, and install the winner with ready-to-use `@font-face` CSS — in a handful of
  4. small, cheap tool calls.
  5. Starts with [dafont.com](https://www.dafont.com) (~100k free fonts in 90 categories). Built so more providers
  6. slot in behind the same commands.
  7. ```text
  8. $ fontetto search -c brush -l commercial -n 5
  9. 5 fonts from dafont · page 1/13 · licence: ✓ commercial ok, ✗ not, ? read terms
  10. anak-bocil Anak Bocil — Khurasan™ · Script > Brush · free ✓ · 2.1k dl · 2 files
  11. brusher Brusher — Vlad Cristea · Script > Brush · free ✓ · 1.8M dl
  12. edo-sz Edo SZ — Vic Fieger · Script > Brush · free ✓ · 4.4M dl · accents
  13. ninja-naruto Ninja Naruto — sk89q · Script > Brush · free ✓ · 2.5M dl
  14. hey-august Hey August — Khurasan™ · Script > Brush · free ✓ · 1.6M dl · 2 files · accents
  15. $ fontetto info edo-sz --files # what the font files can set — often enough to decide
  16. reads NO LOWERCASE · latin, latin-1
  17. family font-family: 'Edo SZ', cursive
  18. …
  19. $ fontetto preview edo-sz brusher anak-bocil -t "Acme Coffee Co." # only when looks decide: ONE numbered sheet
  20. $ fontetto get edo-sz -o public/fonts
  21. Edo SZ → ./public/fonts/edo-sz
  22. css ./public/fonts/edo-sz/font-face.css
  23. link <link rel="stylesheet" href="public/fonts/edo-sz/font-face.css">
  24. use font-family: 'Edo SZ', cursive;
  25. reads NO LOWERCASE · latin, latin-1
  26. licence 100% Free — commercial ok
  27. faces
  28. 'Edo SZ' 400 normal ← edosz.ttf
  29. note serve the page over http(s) — data: URLs cannot load font files
  30. ```
  31. ## Why a skill (and not just an MCP server)
  32. Agent context is the scarce resource, so fontetto ships as a **skill + CLI** first:
  33. | | Idle cost in every conversation | Cost when used |
  34. | --- | --- | --- |
  35. | **Skill** (recommended) | ~120 tokens (its one-line description) | ~1.5k tokens to load the workflow, then compact CLI output |
  36. | MCP server | ~850 tokens of tool schemas, always | Same compact output |
  37. The commands are shaped to keep both tool calls and tokens down:
  38. - **Compact output.** One line per font with the fields that drive a decision (licence first-class), ~8× smaller
  39. than the same results as JSON. `--json` is there when a program wants it.
  40. - **Text before pixels.** `info --files` reads the font files themselves and reports what previews would
  41. otherwise reveal: `NO LOWERCASE` (capitals or unicase — wrong for body text), missing digits, monospace,
  42. and the scripts actually covered (Latin-1, Cyrillic, Devanagari…). Previews become optional.
  43. - **One look, not one per font.** `preview a b c` renders every candidate in your copy into a single
  44. numbered contact sheet.
  45. - **One search, many words.** `search script cursive handwriting --any` merges and de-duplicates the matches.
  46. - **Paste-ready install.** `get` prints the `<link>` tag and the `font-family` rule (with the native pixel size
  47. for bitmap fonts).
  48. Measured on the same request (a letter with a Hindi-style heading, a monospace bitmap body and an 8-bit
  49. cursive signature): the font hunt went from 9 searches and 11 image reads to 3 searches, one `info --files` and
  50. one `get` — with no images needed at all.
  51. The MCP server is still included for agents that speak MCP but not skills — same core, same output.
  52. ## Install
  53. **Claude Code (plugin with the skill)** — runs straight from source on Node ≥ 22.18, nothing to build:
  54. ```text
  55. /plugin marketplace add Bit-Trading-Company/fontetto
  56. /plugin install fontetto@fontetto
  57. ```
  58. **CLI**
  59. ```bash
  60. npm install -g github:Bit-Trading-Company/fontetto
  61. ```
  62. **MCP server** (Claude Desktop, Cursor, any MCP client)
  63. ```bash
  64. claude mcp add fontetto -- npx -y github:Bit-Trading-Company/fontetto mcp
  65. ```
  66. ```json
  67. { "mcpServers": { "fontetto": { "command": "npx", "args": ["-y", "github:Bit-Trading-Company/fontetto", "mcp"] } } }
  68. ```
  69. Tools: `search_fonts` (`any` for several words), `font_info` (`files` for case/scripts/digits), `preview_fonts`
  70. (returns one contact-sheet image), `get_font`, `list_categories`, `tag_font`.
  71. ## Commands
  72. | Command | |
  73. | --- | --- |
  74. | `fontetto search [words] [-c category] [-l licence] [-s sort] [-n N] [--any]` | Find fonts by name words (all, or `--any` of them), category, licence, author (`--author`), or your tags (`--tag`). |
  75. | `fontetto info <font>… [--files]` | Everything the provider knows — see below. `--files` adds what the font files can set. |
  76. | `fontetto preview <font>… [-t text]` | One numbered contact-sheet PNG of all the fonts, in your own text. |
  77. | `fontetto get <font>… [-o dir]` | Download, unpack, write `font-face.css` and `fontetto.json`; print a paste-ready snippet. |
  78. | `fontetto categories` | The category tree. |
  79. | `fontetto tag <font> <tag>… [-r tag]` · `fontetto tags` | Your own tags. |
  80. | `fontetto mcp` | Run as an MCP server on stdio. |
  81. `<font>` is a slug (`bebas-neue`), `dafont:bebas-neue` or a dafont URL. Categories accept dafont's names
  82. (`handwritten`, `script/brush`), ids (`604`), whole groups (`techno`) and designer vocabulary
  83. (`monospace`, `pixel`, `blackletter`, `grotesk`). Licence filters: `commercial` (open + 100% free), `open`,
  84. or explicit kinds.
  85. ## What you get from dafont
  86. | Field | Notes |
  87. | --- | --- |
  88. | name, slug, author (+ website, handle for "more by this author") | |
  89. | category | e.g. `Script > Handwritten`, with dafont's id |
  90. | licence | dafont's label → `open` · `free` · `personal` · `donationware` · `shareware` · `demo` · `unknown`, plus `commercial: true / false / null` |
  91. | author's note | Often the real terms. When it mentions commercial use, `commercial` becomes `null` ("read terms") instead of trusting the label |
  92. | styles | every font file in the download, each with its own preview |
  93. | downloads (total, yesterday), comments | a decent quality signal |
  94. | charset | accents, euro sign |
  95. | glyph count, size, added/updated dates, old versions, showcase image | |
  96. | bitmap pixel size | pixel fonts list their native size (use multiples, anti-aliasing off) |
  97. With `info --files` (before installing) and `get`, fontetto reads the font files themselves (OpenType `name`,
  98. `OS/2`, `head`, `maxp`, `post`, `cmap`, `glyf`) for the true family name, weight, italic, width
  99. (→ `font-stretch`), fixed pitch, case (does it have real lowercase, judged by drawn heights, not just
  100. glyph slots), digits, script coverage and any embedded licence (e.g. the OFL or CC BY-SA), so the CSS is right
  101. even when file names are not. The same face shipped as WOFF2/WOFF/OTF/TTF becomes one `@font-face`
  102. with every format, best first. `fontetto.json` records where the font came from and under which licence.
  103. ## Your own tags
  104. ```bash
  105. fontetto tag edo-sz brand-acme approved
  106. fontetto search --tag brand-acme
  107. ```
  108. Tags live in `~/.config/fontetto/tags.json` together with a snapshot of each tagged font, so tag searches
  109. are instant and offline. Point `FONTETTO_TAGS` at a file in a repo to share a curated set with your team.
  110. ## As a library
  111. ```ts
  112. import { search, get } from 'fontetto';
  113. const { fonts } = await search({ category: 'handwritten', license: 'commercial', limit: 5 });
  114. const { css, families } = await get(fonts[0].id, { dir: 'public/fonts' });
  115. ```
  116. ## Being a good guest
  117. fontetto is not a crawler. It fetches only the single page or file an agent asks for, identifies itself
  118. (`fontetto/<version> (+repo URL)`), waits between requests, and caches everything on disk — listings for a
  119. day, font pages for a week, downloads for months — so repeated questions never reach the provider.
  120. `FONTETTO_OFFLINE=1` serves from the cache only.
  121. Fonts belong to their authors. fontetto surfaces each licence and the author's note precisely so agents
  122. respect them; read the terms before commercial use.
  123. ## Development
  124. ```bash
  125. npm install
  126. npm test # unit + end-to-end CLI/MCP tests, fully offline (saved pages in test/fixtures)
  127. npm run test:live # the same flow against dafont.com
  128. npm run typecheck
  129. npm run fixtures # refresh the saved pages after a markup change
  130. node src/cli.ts … # run from source — Node strips the types, no build step
  131. ```
  132. ```text
  133. src/
  134. cli.ts command line
  135. mcp.ts MCP server (stdio, dependency-free)
  136. fontetto.ts the API: search · info · preview · get · tags
  137. format.ts compact agent-facing output
  138. types.ts the shared vocabulary every provider speaks
  139. tags.ts your tags
  140. providers/
  141. index.ts registry
  142. dafont/ categories · parse (pure HTML → data) · provider (URLs, filters)
  143. lib/ http (cache, politeness) · zip · sfnt, cmap, traits (font files) · faces · css
  144. png, sheet (contact sheets) · html · licence
  145. skills/fontetto/ the agent skill
  146. test/ fixtures, builders for synthetic zips and fonts, tests
  147. ```
  148. ### Adding a provider
  149. Implement `Provider` from [`src/types.ts`](src/types.ts) — `categories`, `search`, `info`, `download` — in
  150. `src/providers/<name>/`, keep parsing pure and test it against saved pages, and register it in
  151. [`src/providers/index.ts`](src/providers/index.ts). Search, info, preview, get, tags, CLI and MCP pick it up;
  152. fonts are addressed as `<name>:<slug>`.
  153. Zero runtime dependencies. MIT © [Bit Trading Company](https://bit-trading-company.com).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.