fontetto
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.
Badge for your README
Markdown
[](/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
- {
- "name": "fontetto",
- "owner": {
- "name": "Bit Trading Company",
- "url": "https://bit-trading-company.com"
- },
- "metadata": {
- "description": "Fonts for design agents: find, preview, licence-check and install fonts from dafont."
- },
- "plugins": [
- {
- "name": "fontetto",
- "source": "./",
- "description": "Find, preview and install custom fonts (dafont) with licence checks and @font-face CSS — as a skill.",
- "version": "0.1.0",
- "category": "design",
- "keywords": ["fonts", "typography", "dafont", "font-face", "design"]
- }
- ]
- }
README.md · README · 196 lines
- # fontetto
- **Fonts for design agents.** Search third-party font providers by style and licence, look at candidates
- rendered with your own copy, and install the winner with ready-to-use `@font-face` CSS — in a handful of
- small, cheap tool calls.
- Starts with [dafont.com](https://www.dafont.com) (~100k free fonts in 90 categories). Built so more providers
- slot in behind the same commands.
- ```text
- $ fontetto search -c brush -l commercial -n 5
- 5 fonts from dafont · page 1/13 · licence: ✓ commercial ok, ✗ not, ? read terms
- anak-bocil Anak Bocil — Khurasan™ · Script > Brush · free ✓ · 2.1k dl · 2 files
- brusher Brusher — Vlad Cristea · Script > Brush · free ✓ · 1.8M dl
- edo-sz Edo SZ — Vic Fieger · Script > Brush · free ✓ · 4.4M dl · accents
- ninja-naruto Ninja Naruto — sk89q · Script > Brush · free ✓ · 2.5M dl
- hey-august Hey August — Khurasan™ · Script > Brush · free ✓ · 1.6M dl · 2 files · accents
- $ fontetto info edo-sz --files # what the font files can set — often enough to decide
- reads NO LOWERCASE · latin, latin-1
- family font-family: 'Edo SZ', cursive
- …
- $ fontetto preview edo-sz brusher anak-bocil -t "Acme Coffee Co." # only when looks decide: ONE numbered sheet
- $ fontetto get edo-sz -o public/fonts
- Edo SZ → ./public/fonts/edo-sz
- css ./public/fonts/edo-sz/font-face.css
- link <link rel="stylesheet" href="public/fonts/edo-sz/font-face.css">
- use font-family: 'Edo SZ', cursive;
- reads NO LOWERCASE · latin, latin-1
- licence 100% Free — commercial ok
- faces
- 'Edo SZ' 400 normal ← edosz.ttf
- note serve the page over http(s) — data: URLs cannot load font files
- ```
- ## Why a skill (and not just an MCP server)
- Agent context is the scarce resource, so fontetto ships as a **skill + CLI** first:
- | | Idle cost in every conversation | Cost when used |
- | --- | --- | --- |
- | **Skill** (recommended) | ~120 tokens (its one-line description) | ~1.5k tokens to load the workflow, then compact CLI output |
- | MCP server | ~850 tokens of tool schemas, always | Same compact output |
- The commands are shaped to keep both tool calls and tokens down:
- - **Compact output.** One line per font with the fields that drive a decision (licence first-class), ~8× smaller
- than the same results as JSON. `--json` is there when a program wants it.
- - **Text before pixels.** `info --files` reads the font files themselves and reports what previews would
- otherwise reveal: `NO LOWERCASE` (capitals or unicase — wrong for body text), missing digits, monospace,
- and the scripts actually covered (Latin-1, Cyrillic, Devanagari…). Previews become optional.
- - **One look, not one per font.** `preview a b c` renders every candidate in your copy into a single
- numbered contact sheet.
- - **One search, many words.** `search script cursive handwriting --any` merges and de-duplicates the matches.
- - **Paste-ready install.** `get` prints the `<link>` tag and the `font-family` rule (with the native pixel size
- for bitmap fonts).
- Measured on the same request (a letter with a Hindi-style heading, a monospace bitmap body and an 8-bit
- cursive signature): the font hunt went from 9 searches and 11 image reads to 3 searches, one `info --files` and
- one `get` — with no images needed at all.
- The MCP server is still included for agents that speak MCP but not skills — same core, same output.
- ## Install
- **Claude Code (plugin with the skill)** — runs straight from source on Node ≥ 22.18, nothing to build:
- ```text
- /plugin marketplace add Bit-Trading-Company/fontetto
- /plugin install fontetto@fontetto
- ```
- **CLI**
- ```bash
- npm install -g github:Bit-Trading-Company/fontetto
- ```
- **MCP server** (Claude Desktop, Cursor, any MCP client)
- ```bash
- claude mcp add fontetto -- npx -y github:Bit-Trading-Company/fontetto mcp
- ```
- ```json
- { "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`.
- ## Commands
- | Command | |
- | --- | --- |
- | `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`). |
- | `fontetto info <font>… [--files]` | Everything the provider knows — see below. `--files` adds what the font files can set. |
- | `fontetto preview <font>… [-t text]` | One numbered contact-sheet PNG of all the fonts, in your own text. |
- | `fontetto get <font>… [-o dir]` | Download, unpack, write `font-face.css` and `fontetto.json`; print a paste-ready snippet. |
- | `fontetto categories` | The category tree. |
- | `fontetto tag <font> <tag>… [-r tag]` · `fontetto tags` | Your own tags. |
- | `fontetto mcp` | Run as an MCP server on stdio. |
- `<font>` is a slug (`bebas-neue`), `dafont:bebas-neue` or a dafont URL. Categories accept dafont's names
- (`handwritten`, `script/brush`), ids (`604`), whole groups (`techno`) and designer vocabulary
- (`monospace`, `pixel`, `blackletter`, `grotesk`). Licence filters: `commercial` (open + 100% free), `open`,
- or explicit kinds.
- ## What you get from dafont
- | Field | Notes |
- | --- | --- |
- | name, slug, author (+ website, handle for "more by this author") | |
- | category | e.g. `Script > Handwritten`, with dafont's id |
- | licence | dafont's label → `open` · `free` · `personal` · `donationware` · `shareware` · `demo` · `unknown`, plus `commercial: true / false / null` |
- | author's note | Often the real terms. When it mentions commercial use, `commercial` becomes `null` ("read terms") instead of trusting the label |
- | styles | every font file in the download, each with its own preview |
- | downloads (total, yesterday), comments | a decent quality signal |
- | charset | accents, euro sign |
- | glyph count, size, added/updated dates, old versions, showcase image | |
- | bitmap pixel size | pixel fonts list their native size (use multiples, anti-aliasing off) |
- With `info --files` (before installing) and `get`, fontetto reads the font files themselves (OpenType `name`,
- `OS/2`, `head`, `maxp`, `post`, `cmap`, `glyf`) for the true family name, weight, italic, width
- (→ `font-stretch`), fixed pitch, case (does it have real lowercase, judged by drawn heights, not just
- glyph slots), digits, script coverage and any embedded licence (e.g. the OFL or CC BY-SA), so the CSS is right
- even when file names are not. The same face shipped as WOFF2/WOFF/OTF/TTF becomes one `@font-face`
- with every format, best first. `fontetto.json` records where the font came from and under which licence.
- ## Your own tags
- ```bash
- fontetto tag edo-sz brand-acme approved
- fontetto search --tag brand-acme
- ```
- Tags live in `~/.config/fontetto/tags.json` together with a snapshot of each tagged font, so tag searches
- are instant and offline. Point `FONTETTO_TAGS` at a file in a repo to share a curated set with your team.
- ## As a library
- ```ts
- import { search, get } from 'fontetto';
- const { fonts } = await search({ category: 'handwritten', license: 'commercial', limit: 5 });
- const { css, families } = await get(fonts[0].id, { dir: 'public/fonts' });
- ```
- ## Being a good guest
- fontetto is not a crawler. It fetches only the single page or file an agent asks for, identifies itself
- (`fontetto/<version> (+repo URL)`), waits between requests, and caches everything on disk — listings for a
- day, font pages for a week, downloads for months — so repeated questions never reach the provider.
- `FONTETTO_OFFLINE=1` serves from the cache only.
- Fonts belong to their authors. fontetto surfaces each licence and the author's note precisely so agents
- respect them; read the terms before commercial use.
- ## Development
- ```bash
- npm install
- npm test # unit + end-to-end CLI/MCP tests, fully offline (saved pages in test/fixtures)
- npm run test:live # the same flow against dafont.com
- npm run typecheck
- npm run fixtures # refresh the saved pages after a markup change
- node src/cli.ts … # run from source — Node strips the types, no build step
- ```
- ```text
- src/
- cli.ts command line
- mcp.ts MCP server (stdio, dependency-free)
- fontetto.ts the API: search · info · preview · get · tags
- format.ts compact agent-facing output
- types.ts the shared vocabulary every provider speaks
- tags.ts your tags
- providers/
- index.ts registry
- dafont/ categories · parse (pure HTML → data) · provider (URLs, filters)
- lib/ http (cache, politeness) · zip · sfnt, cmap, traits (font files) · faces · css
- png, sheet (contact sheets) · html · licence
- skills/fontetto/ the agent skill
- test/ fixtures, builders for synthetic zips and fonts, tests
- ```
- ### Adding a provider
- Implement `Provider` from [`src/types.ts`](src/types.ts) — `categories`, `search`, `info`, `download` — in
- `src/providers/<name>/`, keep parsing pure and test it against saved pages, and register it in
- [`src/providers/index.ts`](src/providers/index.ts). Search, info, preview, get, tags, CLI and MCP pick it up;
- fonts are addressed as `<name>:<slug>`.
- Zero runtime dependencies. MIT © [Bit Trading Company](https://bit-trading-company.com).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.