# Oh My Posh Validator

> Oh My Posh Validator is a free MCP server for developer tools. Validates Oh My Posh theme files and single segments against the official schema. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://ohmyposh.dev/docs/advanced/mcp-server
- **Repository:** https://github.com/jandedobbeleer/oh-my-posh/tree/HEAD/website/api/mcp
- **MCP Registry name:** dev.ohmyposh/validator
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

The validator is a hosted endpoint, so there is nothing to install: an MCP client points at the HTTPS URL and asks the assistant to check a theme. It accepts JSON, YAML and TOML and detects the format on its own when none is given.

Two tools are exposed. One checks a whole configuration; the other checks a single prompt segment snippet, which helps when you are testing a segment before adding it to a full theme. Results list errors with the JSON path, the failing validation keyword and the offending data, plus warnings such as a missing `$schema` property or deprecations.

The endpoint is an Azure Function that lives in the Oh My Posh repository, and the docs also show how to call it with plain curl and JSON-RPC.

## Features

- **Whole-config validation:** Checks a complete theme against the official Oh My Posh JSON schema.
- **Segment snippet check:** Validates one prompt segment on its own before it goes into a theme.
- **JSON, YAML and TOML:** Accepts all three formats and auto-detects which one was sent.
- **Path-level errors:** Reports each error with its JSON path, message and failing keyword.
- **Warnings and recommendations:** Flags best-practice hints and deprecated settings alongside errors.
- **Remote, no install:** Runs over streamable HTTP at a public URL, also callable with curl.

## Good for

- Check a hand-edited theme before reloading the shell
- Have an assistant fix schema errors in a YAML or TOML config
- Test a new segment snippet in isolation
- Validate themes in a script through the direct HTTP API

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http validator https://ohmyposh.dev/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://ohmyposh.dev/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "validator": {
      "url": "https://ohmyposh.dev/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "validator": {
      "type": "http",
      "url": "https://ohmyposh.dev/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "validator": {
      "serverUrl": "https://ohmyposh.dev/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "validator": {
      "type": "http",
      "url": "https://ohmyposh.dev/api/mcp"
    }
  }
}
```

## Tools

- `validate_config`: Validates a full Oh My Posh configuration in JSON, YAML or TOML.
- `validate_segment`: Validates a single prompt segment snippet against the segment schema.

## FAQ

### Which formats can it validate?

JSON, YAML and TOML, with automatic format detection by default.

### Do I need to install anything?

No. The server is remote; add its HTTPS URL to an MCP client such as Claude Desktop or Cline.

### What does a result contain?

A valid flag, a list of errors, warnings, the detected format and the parsed configuration.

### Can I call it without an MCP client?

Yes. The docs show curl requests for server info, tools/list and tools/call.

### Is Oh My Posh Validator free?

Yes. Oh My Posh Validator is free to use.

### How do I add Oh My Posh Validator to Claude Code?

Run this command in your terminal: claude mcp add --transport http validator https://ohmyposh.dev/api/mcp

### What are the best alternatives to Oh My Posh Validator?

The closest alternatives to Oh My Posh Validator are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/oh-my-posh-validator
