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

Related MCP server: conductor-figma

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

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:

analyze_project_and_recommend

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

Parameters:

analyze_website

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

Parameters:

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:

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:

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