Submit
Microck

Font MCP

Community Microck
Updated

an expert design advisor mcp that finds the best fonts for your project via live research and project scanning.

Font MCP

An expert design advisor MCP server that finds, pairs, and sets up the best fonts for your project.

Font MCP doesn't just list fonts — it researches live discussions (Reddit, Typewolf), scans your project files for "vibe", and automatically hunts down font files for your setup.

Table of Contents

  • Quick Start
  • Features
  • Installation
  • Usage
  • Tools Reference
  • Font Hunter Logic
  • Configuration
  • How It Works
  • License

Quick Start

OpenCode

Tell OpenCode:

fetch and follow instructions from https://raw.githubusercontent.com/Microck/font-mcp/master/.opencode/INSTALL.md

Codex

Tell Codex:

fetch and follow instructions from https://raw.githubusercontent.com/Microck/font-mcp/master/.codex/INSTALL.md

Features

  • Live Research — Searches Reddit (r/typography, r/web_design) and design archives (Typewolf, FontsInUse) for real-world usage examples and expert recommendations.
  • Project Scanning — Analyzes your package.json and config files to detect your project's "vibe" and technical stack automatically.
  • Steal This Look — Scans any website URL to identify what fonts they are using and whether they're paid or free.
  • Auto-Setup — Generates Tailwind or CSS configuration and automatically downloads font files.
  • Font Hunter v2 — Exhaustive search engine that tries GitHub, GitLab, VK, Archive.org, and open directories to find your font files.
  • No-Free Fallback — Strictly stays on S-tier/paid fonts unless you explicitly enable free fallback in config.

Installation

Prerequisites

  • Node.js 18+
  • npm or your preferred package manager

Build from Source

git clone https://github.com/Microck/font-mcp.git
cd font-mcp
npm install
npm run build

Development

npm run dev

Usage

Tools Reference

Tool Description
consult_font_expert Get recommendations based on a vibe or description
analyze_project_and_recommend Auto-detect vibe from your project path and recommend fonts
analyze_website Reverse-engineer the typography of any website URL
setup_font_config Generate setup code and download font files automatically

consult_font_expert

Get expert font recommendations based on a vibe, project type, or visual description. Uses live research from Reddit, Typewolf, and FontsInUse.

Parameters:

Parameter Type Required Description
vibe string Yes Description of the project or aesthetic (e.g., "luxury", "tech startup", "editorial", "playful")
allow_paid boolean No Whether to include paid/commercial fonts (default: true)

analyze_project_and_recommend

Scans the project directory (package.json, config files) to automatically detect the "vibe" and recommend suitable fonts.

Parameters:

Parameter Type Required Description
project_path string Yes Absolute path to the project root
allow_paid boolean No Whether to include paid/commercial fonts (default: true)

analyze_website

Analyze a live website URL to identify which fonts it uses ("Steal this look").

Parameters:

Parameter Type Required Description
url string Yes The website URL to analyze

setup_font_config

Generate CSS or Tailwind configuration and setup instructions for a specific font. Automatically attempts to download the font files for testing purposes (assuming you have a valid license).

Parameters:

Parameter Type Required Description
font_name string Yes Name of the font
is_paid boolean Yes Whether this is a paid font
type string No Output format: "tailwind" or "css" (default: "tailwind")

Example

{
  "name": "setup_font_config",
  "arguments": {
    "font_name": "Helvetica Now",
    "is_paid": true,
    "type": "tailwind"
  }
}

Font Hunter Logic

The tool assumes you own a valid license for any commercial font. It uses multiple strategies to locate files:

  1. Direct CDN / GitHub raw patterns.
  2. Community sharing hubs (VK, Telegram indices).
  3. Open directory dorking (Google/browser search).
  4. Last resort: Writes a HUNTING_INSTRUCTIONS.txt with specific search queries if auto-download fails.

Configuration

You can tweak the behavior in your MCP config:

Option Type Default Description
maxDownloadAttempts number 10 Number of download strategies to try
downloadTimeoutMs number 30000 Timeout in milliseconds for each font download request
outputDir string './public/fonts' Directory where downloaded font files and hunt artifacts are written
allowFreeFontsFallback boolean false Set to true to allow Google Fonts fallback

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   AI Agent      │────▶│   Font MCP   │────▶│  Research Service │
│  (MCP Client)   │     │   Server     │     │  (Reddit, Typewolf)│
└─────────────────┘     └──────┬───────┘     └──────────────────┘
                               │
                    ┌──────────┼──────────┐
                    ▼          ▼          ▼
            ┌──────────┐ ┌──────────┐ ┌──────────┐
            │ Project  │ │   Web    │ │   Font   │
            │ Scanner  │ │ Detector │ │  Hunter  │
            └──────────┘ └──────────┘ └──────────┘
  • ResearchService — Queries Reddit, Typewolf, and FontsInUse for live font recommendations.
  • ProjectScannerService — Reads package.json and config files to detect project vibe and tech stack.
  • WebFontDetectorService — Scrapes websites to identify font families in use.
  • ConfigGeneratorService — Produces Tailwind or vanilla CSS configuration snippets.
  • FontHunterService — Multi-strategy font file downloader (CDN, GitHub, community hubs, open directories).

License

MIT

MCP Server · Populars

MCP Server · New