ghostty-config-mcp
MCP server for managing Ghostty terminal emulator configuration, allowing users to view version, search config docs, validate config, list fonts/themes, and inspect current settings.
Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
shyuan
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
ghostty_get_config_optionGet full documentation for a specific Ghostty config option. Supports fuzzy matching if exact key is not found.
ghostty_list_actionsList actions that can be bound to keybindings in Ghostty
ghostty_list_colorsList named colors available in Ghostty
ghostty_list_fontsList available font families and their faces
ghostty_list_keybindsList current keybindings in Ghostty
ghostty_list_themesList available Ghostty themes
ghostty_search_config_docsSearch Ghostty configuration documentation by keyword. Returns matching config options with their docs and default values.
ghostty_show_current_configShow the currently active Ghostty configuration. Use changes_only=true to see only user-modified values.
ghostty_show_faceShow which font face Ghostty uses to render specific characters
ghostty_validate_configValidate a Ghostty config file for syntax errors. Without arguments, validates the default config.
ghostty_versionShow the installed Ghostty version and build info
Tool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
11/11 tools missing one or more hints — ghostty_get_config_option (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); ghostty_list_actions (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); ghostty_list_colors (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +8 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Descriptions match behaviour
9 tools describe read intent but their handlers mutate — ghostty_get_config_option (line 12: exec(["--version"])); ghostty_list_actions (line 14: exec(["+list-actions", "--docs"])); ghostty_list_colors (line 12: exec(["+list-colors", "--plain"]))
Rename the tool, rewrite the description, or move the side-effect into a separate clearly-named tool.
Tool inputs are validated
10/11 tool handlers declare input schemas (91%)
Declare an inputSchema with zod/joi/yup on every tool definition.
Tool handlers catch errors
Only 0/11 tool handlers wrap calls in try/catch (0%)
Wrap each tool handler body in try/catch and return a structured error response.
Tests exist
No test files found
Add tests that exercise each declared tool.
Tool description accuracy
9 tools have description/behavior mismatches: ghostty_get_config_option: description implies read-only but handler writes/deletes/executes; ghostty_list_actions: description implies read-only but handler writes/deletes/executes; ghostty_list_colors: description implies read-only but handler writes/deletes/executes
Update tool descriptions to accurately reflect all capabilities — especially write, delete, or execute operations.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/shyuan/ghostty-config-mcp)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check