Software / Codex CLI
Software · MCP
Available now

Codex CLI

Wire YoFont straight into OpenAI Codex CLI. Generate a font family from a prompt or a reference image, poll it while it renders, and pull the finished ttf/otf/woff/woff2 files onto disk — all without leaving the terminal.

// Setup

Connect Codex CLI to YoFont

Three steps, about two minutes. Codex CLI talks to YoFont over the same Streamable HTTP MCP transport it uses for every other tool.

Create an API key

Grab a free API key from your profile, or from the API/MCP tab — the same key works for the REST API and the MCP server. Then export it in your shell so Codex CLI can read it:

export YOFONT_KEY="yf_live_..."

Add YoFont to config.toml

Codex CLI reads MCP servers from ~/.codex/config.toml — one [mcp_servers.<name>] table per server. Paste the block below in (create the file if it doesn't exist yet).

Start Codex CLI and ask for a font

Run codex, describe the font you want, and Codex will call generate_font, poll check_font_status for you, then use download_font to save the finished files straight into your project.

# ~/.codex/config.toml
[mcp_servers.yofont]
url = "https://yofont.com/api/public/mcp"
bearer_token_env_var = "YOFONT_KEY"
// Tools

5 tools, one MCP server

Everything generate_font can do, plus polling, direct downloads and language lookups — all exposed as MCP tools Codex CLI can call on its own.

generate_font

Generate a brand-new font family from a prompt and/or a reference image URL. Runs as an async job and returns a link to poll.

check_font_status

Poll a font job by its link. Once it's ready, returns direct ttf/otf/woff/woff2 URLs — no auth needed to fetch the files themselves.

download_font

Fetch a font file's bytes inline for a given link and format (ttf/otf/woff/woff2), so Codex can write it straight to disk in your project. Falls back to a plain URL for unusually large files.

list_languages

List every supported ISO-2 language code, with glyph counts and text direction.

list_my_fonts

List your last 100 font jobs — status, model, source, and a link to each font's page.

See the full parameter tables in the MCP reference →
// Try it

Example prompts

Type these straight into Codex CLI once it's connected — no dashboard required.

🔤
A font for your CLI

"Generate a technical monospace-adjacent display font for our CLI's ASCII banners, English only."

🌐
Language coverage

"List every language YoFont supports and tell me which ones use a non-Latin script."

🖼️
From a reference image

"Generate a font from this reference image [url], standard quality, then show me all my fonts once it's done."

Not using Codex CLI?

The same MCP server works with Claude Code, Cursor and any other Streamable HTTP MCP client — or call the plain REST API directly.

← Back to Software Full MCP tool reference →