Skip to content
MCP server

Oh My Posh Validator

Validates Oh My Posh theme files and single segments against the official schema

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
31.8.0
Listing updated
2 days ago

About Oh My Posh Validator

Oh My Posh Validator is a free MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://ohmyposh.dev/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "validator": {
      "url": "https://ohmyposh.dev/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

No price published; remote endpoint with no sign-up described

Prices change. Check ohmyposh.dev before you buy.

Oh My Posh Validator 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 to Oh My Posh Validator

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools