1. Made by
“The Oh My Posh MCP (Model Context Protocol) Server is a validation service that allows you to validate your oh-my-posh theme configurations against the official JSON schema.”
The server lives in the Oh My Posh repository itself and runs on the project's own domain ohmyposh.dev, which also documents it; the registry name dev.ohmyposh matches that domain.
ohmyposh.dev/docs/advanced/mcp-server2. Keys
“Configure your MCP-compatible client (like Claude Desktop, Cline, or other AI assistants) to use the validator:”
The docs give one JSON block for any MCP client; they name no separate Claude Code, Cursor or Codex command.
ohmyposh.dev/docs/advanced/mcp-server3. Runs
Endpoint: https://ohmyposh.dev/api/mcp. Checked: unclear: one unauthenticated HEAD to https://ohmyposh.dev/api/mcp answered 404, as expected, because the function accepts only GET, POST and OPTIONS (function.json); not re-checked with GET.
ohmyposh.dev/api/mcp4. Commercial use
“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction”
The service is free with no sign-up, and the Oh My Posh code is MIT-licensed.
github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/COPYINGChecked against its repository at one commit, on Nov 10, 2026. Tap a verdict to see its source.How we checkedReport an error
What Oh My Posh Validator does
Oh My Posh draws a custom prompt line in your terminal, with your folder, branch and other details. This free online checker lets your AI assistant test an Oh My Posh settings file, or one piece of it, before you load it. It says exactly which line is wrong and why.
What people use it for
Check a new prompt theme before loading it
Your assistant edits your theme file, then checks the whole file. A broken file is caught before your terminal shows an error at startup.
Try one prompt piece on its own
Test a single block, such as the folder path or the git branch, before you add it to your full theme.
Find the exact broken setting
When a theme fails, the checker points to the setting that is wrong, for example a block type that does not exist, and lists the allowed values.
Settings written in YAML or TOML
Keep your theme in the file format you like. The checker reads all three formats Oh My Posh uses and detects which one you sent.
Clean up an old theme after an upgrade
Old themes still work but use outdated names. The checker warns about them, such as a renamed settings field, so you can update the file.
Let your assistant design a prompt for you Idea
Describe the look you want, such as a two-line prompt with time on the right. The assistant writes the theme and checks it before handing it over.
Oh My Posh Validator popularity
Tools it gives your agent (2)
What it sends and its license
the full text of the theme or segment you check
To ohmyposh.dev (the Oh My Posh website's server); on every validate_config or validate_segment call. Opt out: do not send files that hold secrets; or check the file in your editor with the "$schema" line.
The checker is a free public service with no sign-up. Its code is part of Oh My Posh, which is under the MIT license, so you may reuse it with the license notice kept.
The service is free with no sign-up, and the Oh My Posh code is MIT-licensed.
“Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction” source
You may copy or self-host the checker's code if the MIT copyright and permission notice stays with it.
“The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.” source
Is it alive
31.8.0 in the registry, updated Oct 20, 2026
Oh My Posh v32.0.0 on 2026-11-08 (GitHub release); the registry entry still says 31.8.0. Code read at commit b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675.
Alternatives
Oh My Posh Validator This page
ajv
Pick it if you need to check settings files offline in your own script or build
nerd-fonts
Pick it if the prompt shows boxes instead of icons after a valid theme loads
Get started
Tell your AI assistant
“Validate my Oh My Posh theme with the oh-my-posh-validator server (validate_config), fix every error it reports, and show me the corrected file before I reload my shell.”
Connect it
claude mcp add --transport http oh-my-posh-validator https://ohmyposh.dev/api/mcp{
"mcpServers": {
"oh-my-posh-validator": {
"url": "https://ohmyposh.dev/api/mcp"
}
}
}The docs give one JSON block for any MCP client; they name no separate Claude Code, Cursor or Codex command.
Mistakes to avoid
The checker flags "properties" as deprecated and asks for "options".
The segment check stops at once with a missing-property error and skips the full rules.
The checker recommends it, and editors use it to suggest and check fields as you type.
The cmd setup in the docs needs the full path, not a relative one.
Questions
Do I need to install anything?
No. The checker runs on ohmyposh.dev and your AI app reaches it over the web.
Which file formats can it check?
JSON, YAML and TOML. Leave the format on auto and it detects which one you sent.
What does it return?
Whether the file is valid, a list of errors with the path to each bad setting, warnings, and the format it detected.
Can I call it without an AI app?
Yes. It answers plain web requests, for example with curl, using the same tool names.