# Oh My Posh Validator — MCP server card for AI agents

Validate oh-my-posh configurations and segment snippets against the official schema.

Registry name: `dev.ohmyposh/validator` · category: Other · version 31.8.0 · updated 2026-10-20

## Connect
- Remote (Claude Code): `claude mcp add --transport http oh-my-posh-validator https://ohmyposh.dev/api/mcp`

## Facts
- Repository: https://github.com/JanDeDobbeleer/oh-my-posh (23,769 stars)
- Website: https://ohmyposh.dev/docs/advanced/mcp-server

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/dev-ohmyposh-validator/


## Oh My Posh Validator: check terminal prompt settings

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.

### Where to use it
- 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: 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. (idea, not from the official pages)

### How to start
- Add the checker to your AI app as a remote server; it needs no install, account or key.

```
{
  "mcpServers": {
    "oh-my-posh-validator": {
      "type": "http",
      "url": "https://ohmyposh.dev/api/mcp"
    }
  }
}
```

- Ask the assistant to check your theme file, or paste the file into the chat.
- Point Oh My Posh at the checked file with the --config flag in your shell profile, then reload the shell.

```
eval "$(oh-my-posh init bash --config ~/jandedobbeleer.omp.json)"
```


### License
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.

### Good to know
- Nothing to install and no account or key. It only reads the text you send and changes nothing on your computer.
- The whole settings file you send goes to ohmyposh.dev. Take out any passwords or keys before checking it.
- It checks the file against the rules of the newest Oh My Posh, so an older installed version may still reject a setting it accepts.
- A passing check means the file is well formed; it does not show how the prompt looks, and icons still need a Nerd Font in your terminal.

Checked 2026-11-10 against: https://ohmyposh.dev/, https://ohmyposh.dev/docs, https://ohmyposh.dev/docs/advanced/mcp-server, https://ohmyposh.dev/docs/installation/customize, https://ohmyposh.dev/docs/installation/fonts, https://github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/website/api/mcp/README.md, https://github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/website/api/mcp/index.js, https://github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/website/api/mcp/server.json, https://github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/website/api/mcp/function.json, https://github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/website/api/shared/validator.js, https://github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/COPYING, https://github.com/JanDeDobbeleer/oh-my-posh/releases/tag/v32.0.0, https://registry.modelcontextprotocol.io/v0/servers/dev.ohmyposh%2Fvalidator/versions/latest

### Mistakes to avoid
- Don't: Giving a segment a "properties" object, as old themes do → Do: Rename the field to "options" (The checker flags "properties" as deprecated and asks for "options".)
- Don't: Sending a segment to validate_segment without type or style → Do: Always set both "type" and "style" on a segment (The segment check stops at once with a missing-property error and skips the full rules.)
- Don't: Leaving out "$schema" in the theme file → Do: Add "$schema" pointing to the official schema.json (The checker recommends it, and editors use it to suggest and check fields as you type.)
- Don't: Using a relative path or ~ for the config file on Windows cmd → Do: Use the full path to the config file (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.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
