# Oh My Posh Validator

Validates oh-my-posh configurations and single prompt segments against the official schema. Handy when a theme fails to load because of a typo in JSON, YAML or TOML.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 23643
- Author: JanDeDobbeleer
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/JanDeDobbeleer/oh-my-posh/tree/HEAD/website/api/mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator

## What it does

The server exposes two tools. `validate_config` takes a whole config and returns errors with JSON paths, while `validate_segment` checks one prompt segment — useful when you add a block to a theme and want to leave the rest untouched.

Input formats are JSON, YAML and TOML. The response carries `valid`, `errors` and `warnings` arrays, the detected format and the parsed config object. Warnings cover best practices and deprecations, such as a missing `$schema` property.

The server runs at `https://ohmyposh.dev/api/mcp` over HTTP. To test locally, start it from the `website/api` directory with `npm start` and send requests to `http://localhost:7071/api/mcp`. Node.js with npm is required for that local run.

## Requirements
- Remote server: `https://ohmyposh.dev/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http validator https://ohmyposh.dev/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mcp --url https://ohmyposh.dev/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://ohmyposh.dev/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://ohmyposh.dev/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mcp https://ohmyposh.dev/api/mcp
```

## When to use it
- check a theme before wiring it into your shell profile
- find the exact field path that breaks validation
- test a single prompt segment before adding it to a full theme
- catch deprecated fields and schema drift in YAML or TOML
- verify a config an agent generated against the official schema

## Example prompts
- Validate `~/.config/oh-my-posh/theme.json` with validate_config
- Run this segment through validate_segment and show me the errors
- Validate the TOML config and list the warnings

## Similar
- [plugin-validator](https://affpapa.org/en/nevibecode/agents/plugin-validator.md) — subagent · ★ 44635
- [build-evidence-map](https://affpapa.org/en/nevibecode/skills/build-evidence-map.md) — skill · 70 installs
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md