Run GlyphPact from the agent you already use

claude plugin marketplace add omar-hanafy/glyphpact
claude plugin install glyphpact@glyphpact

codex plugin marketplace add omar-hanafy/glyphpact
codex plugin add glyphpact@glyphpact

Start a new session after plugin installation. Claude Code can also run /reload-plugins. Do not add a second manual GlyphPact MCP entry while the plugin is enabled.

Runtime

uvon PATH; GlyphPact requires Python 3.10 or newer.

First start

Network access while uv downloads the pinned package and MCP dependencies.

Later starts

uv reuses its local cache. SVG compilation itself stays local.

Merge, do not overwrite. If your config already has MCP servers, add the glyphpact entry beside them. The blocks below show complete wrappers so each one is safe to copy.

{
  "mcpServers": {
    "glyphpact": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--quiet",
        "--no-progress",
        "--color",
        "never",
        "--no-config",
        "--isolated",
        "--from",
        "glyphpact[mcp]==1.0.1",
        "glyphpact-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "glyphpact": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--quiet",
        "--no-progress",
        "--color",
        "never",
        "--no-config",
        "--isolated",
        "--from",
        "glyphpact[mcp]==1.0.1",
        "glyphpact-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "glyphpact": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--quiet",
        "--no-progress",
        "--color",
        "never",
        "--no-config",
        "--isolated",
        "--from",
        "glyphpact[mcp]==1.0.1",
        "glyphpact-mcp"
      ]
    }
  }
}

{
  "servers": {
    "glyphpact": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--quiet",
        "--no-progress",
        "--color",
        "never",
        "--no-config",
        "--isolated",
        "--from",
        "glyphpact[mcp]==1.0.1",
        "glyphpact-mcp"
      ]
    }
  }
}

{
  "context_servers": {
    "glyphpact": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--quiet",
        "--no-progress",
        "--color",
        "never",
        "--no-config",
        "--isolated",
        "--from",
        "glyphpact[mcp]==1.0.1",
        "glyphpact-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "glyphpact": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--quiet",
        "--no-progress",
        "--color",
        "never",
        "--no-config",
        "--isolated",
        "--from",
        "glyphpact[mcp]==1.0.1",
        "glyphpact-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "glyphpact": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--quiet",
        "--no-progress",
        "--color",
        "never",
        "--no-config",
        "--isolated",
        "--from",
        "glyphpact[mcp]==1.0.1",
        "glyphpact-mcp"
      ]
    }
  }
}

claude mcp add-json --scope user glyphpact '{"type":"stdio","command":"uv","args":["tool","run","--quiet","--no-progress","--color","never","--no-config","--isolated","--from","glyphpact[mcp]==1.0.1","glyphpact-mcp"]}'

[mcp_servers.glyphpact]
command = "uv"
args = ["tool", "run", "--quiet", "--no-progress", "--color", "never", "--no-config", "--isolated", "--from", "glyphpact[mcp]==1.0.1", "glyphpact-mcp"]

{
  "mcpServers": {
    "glyphpact": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--quiet",
        "--no-progress",
        "--color",
        "never",
        "--no-config",
        "--isolated",
        "--from",
        "glyphpact[mcp]==1.0.1",
        "glyphpact-mcp"
      ]
    }
  }
}

audit_icon_pack
build_icon_font
check_icon_font
read_icon_report

glyphpact://schema/config
glyphpact://schema/report
glyphpact://schema/cli-result

1. Reload the client

   Use the client-specific reload step above. A GUI client may need to restart after uv is installed so its process receives the updated PATH.

2. Check the public surface

   Confirm all four tool names. Resource browsers should also show the three glyphpact:// schema URIs.

3. Start with an audit

   Use an absolute SVG or config path. Keep both fidelity policies at their strict defaults until you have reviewed every finding.

4. Approve writes deliberately

   build_icon_font publishes files.check_icon_font does not rewrite generated output, but it may create the output parent and sibling lock.

Transport

Local stdio. The client starts glyphpact-mcp as a child process and exchanges MCP messages through standard input and output.

Path handling

Tool paths must be absolute and must already exist. The compiler keeps its own canonical symlink, ownership, and unsafe-input checks.

Audit state

Findings live in private local snapshots. One snapshot is capped at 64 MiB; the store holds at most eight snapshots and 128 MiB total. Idle snapshots expire after 15 minutes and all snapshots expire within one hour.

Published writes

Build stages an atomic publication beside the configured output, then replaces only an owned output directory. Build and check use a persistent sibling .glyphpact.lock coordination file.

Report reads

Reports must be stable regular files, are capped at 128 MiB, and are checked against the report schema before paging.

Context limits

Findings pages allow up to 500 items and 1 MiB. One oversized finding is replaced by a small identity summary instead of flooding the client context.

The client cannot find uv

Install uv, close the GUI client completely, and reopen it. GUI apps often keep the PATH they received at launch. If needed, replace "command": "uv" with uv's absolute executable path.

The first connection times out

The first start downloads GlyphPact and its pinned MCP dependencies. Confirm network access, retry once, then inspect the client's MCP log. Later starts use uv's cache.

GlyphPact appears twice

The full plugin already registers the server. Remove or disable the duplicate manual entry, or uninstall the plugin if you only want MCP.

A tool rejects a relative path

Send an absolute existing path. The server may run outside the project directory, so relative paths are rejected rather than resolved against an uncertain working directory.

An audit snapshot expired

Run the audit once more, page the replacement snapshot, and release it when finished. Do not reuse an unknown or expired snapshot ID.

A new GlyphPact release is available

Marketplace users update the plugin. Manual users replace==1.0.1 in their config with the release they intend to run, then restart or reload the server.

Still blocked? Include the client name, GlyphPact version, MCP log, and the tool error in aGitHub issue.