{
 "kind": "mcp",
 "slug": "dev-ohmyposh-validator",
 "path": "mcp/servers/dev-ohmyposh-validator/",
 "name": "Oh My Posh Validator",
 "maker": "JanDeDobbeleer",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Other",
   "mcp/other/"
  ]
 ],
 "lead": "check terminal prompt settings.",
 "chips": [
  {
   "label": "Other",
   "path": "mcp/other/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --transport http oh-my-posh-validator https://ohmyposh.dev/api/mcp"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/JanDeDobbeleer/oh-my-posh"
  },
  {
   "label": "Website",
   "href": "https://ohmyposh.dev/docs/advanced/mcp-server"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "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.",
   "note": "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.",
   "src": "https://ohmyposh.dev/docs/advanced/mcp-server"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "No key needed",
   "status": "yes",
   "sub": "No account",
   "quote": "Configure your MCP-compatible client (like Claude Desktop, Cline, or other AI assistants) to use the validator:",
   "note": "The docs give one JSON block for any MCP client; they name no separate Claude Code, Cursor or Codex command.",
   "src": "https://ohmyposh.dev/docs/advanced/mcp-server"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote",
   "status": "yes",
   "sub": "Nothing runs on your machine",
   "note": "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.",
   "src": "https://ohmyposh.dev/api/mcp"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "Allowed",
   "status": "yes",
   "sub": "MIT license",
   "quote": "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",
   "note": "The service is free with no sign-up, and the Oh My Posh code is MIT-licensed.",
   "src": "https://github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/COPYING"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Oh My Posh Validator does",
   "parts": [
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Check a new prompt theme before loading it",
       "text": "Your assistant edits your theme file, then checks the whole file. A broken file is caught before your terminal shows an error at startup.",
       "idea": false
      },
      {
       "title": "Try one prompt piece on its own",
       "text": "Test a single block, such as the folder path or the git branch, before you add it to your full theme.",
       "idea": false
      },
      {
       "title": "Find the exact broken setting",
       "text": "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.",
       "idea": false
      },
      {
       "title": "Settings written in YAML or TOML",
       "text": "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.",
       "idea": false
      },
      {
       "title": "Clean up an old theme after an upgrade",
       "text": "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.",
       "idea": false
      },
      {
       "title": "Let your assistant design a prompt for you",
       "text": "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": true
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Oh My Posh Validator popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "23.8K",
       "l": "GitHub stars, JanDeDobbeleer/oh-my-posh"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (2)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "validate_config",
       "text": "Checks a whole Oh My Posh settings file (JSON, YAML or TOML) and returns errors with paths, warnings and the format it found. Reads only."
      },
      {
       "name": "validate_segment",
       "text": "Checks one prompt piece (a segment) on its own, before you add it to a theme. Reads only."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "the full text of the theme or segment you check",
       "sub": "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."
      }
     ]
    },
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "Yes",
       "status": "yes",
       "sub": "The service is free with no sign-up, and the Oh My Posh code is MIT-licensed.",
       "quote": "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",
       "src": "https://github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/COPYING"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "You may copy or self-host the checker's code if the MIT copyright and permission notice stays with it.",
       "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
       "src": "https://github.com/JanDeDobbeleer/oh-my-posh/blob/b3dd82baf547a5a8bf2fb2bd6f9c46ac8e570675/COPYING"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "31.8.0 in the registry, updated Oct 20, 2026"
      },
      {
       "l": "Last release",
       "v": "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."
      },
      {
       "l": "Remote endpoint",
       "v": "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",
       "status": "cond"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Oh My Posh Validator",
       "me": true,
       "facts": [
        "23.8K stars",
        "Remote"
       ]
      },
      {
       "name": "ajv",
       "why": "Pick it if you need to check settings files offline in your own script or build",
       "path": null,
       "facts": [
        "Local"
       ]
      },
      {
       "name": "nerd-fonts",
       "why": "Pick it if the prompt shows boxes instead of icons after a valid theme loads",
       "path": null,
       "facts": [
        "Local"
       ]
      }
     ],
     "more": "All other servers",
     "more_path": "mcp/other/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --transport http oh-my-posh-validator https://ohmyposh.dev/api/mcp"
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"oh-my-posh-validator\": {\n      \"url\": \"https://ohmyposh.dev/api/mcp\"\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "small",
     "text": "The docs give one JSON block for any MCP client; they name no separate Claude Code, Cursor or Codex command."
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Giving a segment a \"properties\" object, as old themes do",
       "fix": "Rename the field to \"options\"",
       "why": "The checker flags \"properties\" as deprecated and asks for \"options\"."
      },
      {
       "dont": "Sending a segment to validate_segment without type or style",
       "fix": "Always set both \"type\" and \"style\" on a segment",
       "why": "The segment check stops at once with a missing-property error and skips the full rules."
      },
      {
       "dont": "Leaving out \"$schema\" in the theme file",
       "fix": "Add \"$schema\" pointing to the official schema.json",
       "why": "The checker recommends it, and editors use it to suggest and check fields as you type."
      },
      {
       "dont": "Using a relative path or ~ for the config file on Windows cmd",
       "fix": "Use the full path to the config file",
       "why": "The cmd setup in the docs needs the full path, not a relative one."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I need to install anything?",
       "a": "No. The checker runs on ohmyposh.dev and your AI app reaches it over the web.",
       "evidence": {
        "url": "https://ohmyposh.dev/docs/advanced/mcp-server",
        "quote": "No installation required - access via HTTPS"
       }
      },
      {
       "q": "Which file formats can it check?",
       "a": "JSON, YAML and TOML. Leave the format on auto and it detects which one you sent.",
       "evidence": {
        "url": "https://ohmyposh.dev/docs/advanced/mcp-server",
        "quote": "Automatically detects the format of your configuration"
       }
      },
      {
       "q": "What does it return?",
       "a": "Whether the file is valid, a list of errors with the path to each bad setting, warnings, and the format it detected.",
       "evidence": {
        "url": "https://ohmyposh.dev/docs/advanced/mcp-server",
        "quote": "JSON path to the problematic property"
       }
      },
      {
       "q": "Can I call it without an AI app?",
       "a": "Yes. It answers plain web requests, for example with curl, using the same tool names.",
       "evidence": {
        "url": "https://ohmyposh.dev/docs/advanced/mcp-server",
        "quote": "You can also use the validator directly via HTTP requests."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "dev.ohmyposh/validator"
  ],
  [
   "Category",
   "Other"
  ],
  [
   "Version",
   "31.8.0"
  ],
  [
   "Remote endpoint",
   "https://ohmyposh.dev/api/mcp"
  ],
  [
   "License",
   "MIT"
  ],
  [
   "GitHub",
   "JanDeDobbeleer/oh-my-posh"
  ],
  [
   "In the registry since",
   "Oct 20, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "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."
 ],
 "checked_line": "Read by AgentGid from 13 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/jandedobbeleer.png"
}