# list_fonts

> List fonts with Wavegrain's MCP server: the list_fonts tool needs the read permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**List fonts.** Permission: `read`. Read-only: changes nothing.

Font families with their weights, from the bundled fonts or a search of all Google Fonts, and a sample sheet image.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `query` | string | no | Search all Google Fonts by name. Leave out for the bundled fonts. up to 60 characters |
| `category` | "Sans Serif" \| "Serif" \| "Display" \| "Handwriting" \| "Monospace" | no | Only with query, or alone to browse a category. |

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `fonts` | object[] | Matching font families. |
| `note` | string | What to do next. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_fonts",
    "arguments": {}
  }
}
```

## Related tools

- [`list_creators`](/developers/mcp-tools/list_creators): List AI creators
- [`list_styles`](/developers/mcp-tools/list_styles): List tailored styles
- [`get_style`](/developers/mcp-tools/get_style): Get a style
- [`fetch_reference`](/developers/mcp-tools/fetch_reference): Fetch a reference post
- [`search_images`](/developers/mcp-tools/search_images): Search images
- [`get_tailored_slideshow`](/developers/mcp-tools/get_tailored_slideshow): Get a tailored slideshow
- [All 79 tools](/developers/mcp-tools)
