# fontpool MCP server

> Searches font catalogs by category and tags, retrieves detailed typography metadata, and downloads fonts for self-hosting with generated CSS.

- Repository: https://github.com/travisvaleri/fontpool
- Page: https://hostedmcp.org/servers/travisvaleri/fontpool
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 1.4.1

## Install

### Claude Code

```sh
claude mcp add fontpool -- npx -y fontpool
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "fontpool": {
      "command": "npx",
      "args": [
        "-y",
        "fontpool"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "fontpool": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fontpool"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"fontpool","type":"stdio","command":"npx","args":["-y","fontpool"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "fontpool": {
      "command": "npx",
      "args": [
        "-y",
        "fontpool"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add fontpool -- npx -y fontpool
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.fontpool]
command = "npx"
args = ["-y", "fontpool"]
```

### Gemini CLI

```sh
gemini mcp add -s user fontpool npx -- -y fontpool
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "fontpool": {
      "command": "npx",
      "args": [
        "-y",
        "fontpool"
      ]
    }
  }
}
```

## Tools (3)

- `list_fonts`: Searches every font family fontpool can install, deduplicated, with the category, providers and use-case tags for each. Filter by category or tag to get a shortlist worth choosing between; exclude: ['google'] narrows to the families Google Fonts does not carry, and hasAxis: 'wdth' to variable fonts with a width axis. Call with no arguments to see the category counts, tag vocabulary and axis vocabulary. Use font_properties for the full description of one family.
- `font_properties`: Everything known about one family: weights, styles, subsets, formats and serving provider, plus its category, use-case tags, foundry and the foundry's own description of the design. Read this before choosing — it is what distinguishes one name from another. Variable fonts report weight as a range like '100 900', and list every axis they carry under variableAxes — width, optical size, slant, and any expressive axes the typeface defines.
- `install_font`: Resolves the family, downloads the actual woff2 files into the project, and appends @font-face rules to a CSS file. Self-hosted — no CDN request at runtime. Returns the exact font-family name to use.

## FAQ

### Does fontpool require an API key?

No, the server does not require any API keys or accounts to function.

### How are fonts served to the website?

Fonts are downloaded and self-hosted in your project, meaning no CDN requests are made at runtime.

### Can I search for fonts with specific variable axes?

Yes, you can filter fonts by specific variable axes like weight, width, or optical size.

### Does it support Adobe Fonts?

No, Adobe Fonts are excluded because their terms require loading from Adobe's own CDN, which prevents self-hosting.
