@fontofweb/mcp

MCP Server and CLI installer for Font of Web - design inspiration, font discovery, and design token extraction.

Quick Start

npx @fontofweb/mcp install --token <your-token>

Get your access token at: https://fontofweb.com/mcp

Usage

Install Command

npx @fontofweb/mcp install --token <token> [options]

Token input (one of):

• --token, -t: Your Font of Web API token
• FONTOFWEB_MCP_TOKEN: Environment variable fallback
• Interactive prompt: If no token is provided and terminal is interactive

Optional:

• --assistants, -a: Comma-separated list of assistants or all (default: all)
• --cwd: Project directory for skill installation (default: current directory)
• --dry-run: Preview changes without writing files
• --help, -h: Show help
• --version, -v: Show version

Examples

# Install for all assistants
npx @fontofweb/mcp install --token abc123

# Install for specific assistants only
npx @fontofweb/mcp install --token abc123 --assistants cursor,codex

# Dry run to preview changes
npx @fontofweb/mcp install --token abc123 --dry-run

# Install skills to specific directory
npx @fontofweb/mcp install --token abc123 --cwd ./my-project

Supported Assistants

Auto-Installed (File-based)

The following assistants are automatically configured:

| Assistant | Config Location | |-----------|----------------| | Cursor | ~/.cursor/mcp.json | | Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) | | Codex | ~/.codex/config.toml | | OpenCode | ~/.opencode/mcp.json | | Windsurf | ~/.codeium/windsurf/mcp_config.json | | Zed | ~/.config/zed/settings.json | | Gemini CLI | ~/.gemini/settings.json | | Kiro | ~/.kiro/settings/mcp.json | | Roo Code | ~/.roocode/mcp.json |

Manual Setup Required

The following assistants require manual configuration:

• VS Code: Open Settings → MCP Servers → Add "fontofweb" with URL https://mcp.fontofweb.com/mcp and Authorization header
• Claude Code: Run claude config add mcp.fontofweb.url https://mcp.fontofweb.com/mcp
• Warp: Open Warp → Settings → AI → MCP → Add server
• v0: Configure in v0 settings under MCP Servers

Skills Installation

The installer copies the following skill templates to ./skills/ in your project:

• design-inspiration/SKILL.md - Search design inspiration by query, color, fonts, or domain
• font-discovery/SKILL.md - Discover and research fonts
• token-export/SKILL.md - Extract and export design tokens

Idempotent Updates

The installer safely handles re-runs:

• Generated files (with <!-- FONTofWEB:GENERATED --> marker): Overwritten on update
• User-modified files (no marker): Skipped with warning to preserve your changes

Exit Codes

• 0: All selected installs succeeded
• 1: One or more installs failed (see output for details)
• 2: Invalid arguments or usage error

Development

# Run tests
npm test

# Deploy MCP server
npm run deploy

License

MIT