Skip to main content

Settings and tool profiles

Glyphs MCP has two configuration surfaces:

  • Glyphs UI: Edit -> Glyphs MCP Server
  • Environment variables: optional security, docs, and debugging behavior

Tool profiles​

Tool profiles reduce the tools exposed through tools/list. This matters because many MCP clients include tool names and JSON Schemas in model context.

Choose between the read-only inspection surface and the full editing surface:

ProfileUse when
Read-onlyInspection, metadata, outlines, kerning data, docs, and visual review without mutation tools.
EditThe complete server surface, including edit and execution tools. This is the default.

After changing profiles, restart the server and reconnect the MCP client.

Environment variables​

GLYPHS_MCP_AUTH_TOKEN​

Require a static token on every request.

Accepted headers:

  • Authorization: Bearer <token>
  • mcp-auth-token: <token>

GLYPHS_MCP_ALLOWED_ORIGINS​

Restrict requests by hostname allowlist when an Origin header is present, in addition to default local hosts.

GLYPHS_MCP_REGISTER_DOC_PAGES​

Controls whether every bundled docs page is registered as its own resource.

  • Default: off.
  • Set to 1 only when you need per-page resources.

Prefer docs_search and docs_get for normal work.

GLYPHS_MCP_DOCS_URL​

Override the docs URL shown in the Glyphs MCP status panel.

Current public docs URL:

https://thierryc.github.io/Glyphs-mcp/

GLYPHS_MCP_EXTRA_SITEPACKAGES​

Colon-separated list of additional site-packages directories to add to sys.path.

Example:

export GLYPHS_MCP_EXTRA_SITEPACKAGES="/path/to/site-packages:/another/site-packages"

Use this only for debugging/import fixes.