
Oh My Posh Validator MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude or Cursor check your Oh My Posh theme or a single prompt segment against the official schema and point out what is wrong.
This is a hosted checker for Oh My Posh prompt themes, run by the Oh My Posh project at ohmyposh.dev. Your assistant sends it a theme or a segment, and it replies with errors, the path to each one, and warnings. There is nothing to install and no sign-in. It only checks text; it does not change your theme file or your shell.
Good for
- Oh My Posh users who edit their prompt theme by hand
- Theme authors who want errors with exact paths before they publish
- People who let an assistant write theme changes and want them checked
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install Oh My Posh Validator MCP
Claude Code
- 1
Copy this prompt.
Add the Oh My Posh Validator MCP server to Claude Code. Run this command: claude mcp add --transport http oh-my-posh-validator https://ohmyposh.dev/api/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Built from the package data we hold. Not yet tested by us.
Tools
Checks a full Oh My Posh config against the schema
Takes the text of a whole Oh My Posh theme in JSON, YAML or TOML and checks it against the official schema. It returns whether it is valid, errors with the path to each problem, and warnings such as a missing schema line.
Try: “Validate this Oh My Posh theme and tell me what to fix.”
Network ·
validate_configChecks one prompt segment before you add it to a config
Checks a single prompt segment snippet in JSON, YAML or TOML against the same schema. Use it to test a new segment before you paste it into your theme.
Try: “Is this git segment valid for Oh My Posh? Check it before I add it to my config.”
Network ·
validate_segment
Listed by the running server in our sandbox
Permissions
low risk · 1 thing to watch
Low risk
The assistant sends the theme text you give it to a server at ohmyposh.dev, and gets a check result back. It cannot change files on your machine.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Your theme text goes to ohmyposh.dev
The check runs on the hosted server, so whatever you paste is sent there. Remove secrets or private paths from a theme first. ohmyposh.dev
Security advisories
No published security advisories for the MCP server as of Nov 1, 2026.
2 other advisories are about the wider oh-my-posh project, not this MCP server. See them on GitHub
Technical details
| Turning on read-only | Both tools only validate text and return a result, so there is nothing to switch off. |
|---|---|
| Talks to | ohmyposh.dev (the config or segment text you ask it to check) |
| Sign-in and keys | No account, API key or token. |
Questions
What is the Oh My Posh MCP server URL?
It is https://ohmyposh.dev/api/mcp. Add it to your client as an HTTP server; the install box above has the exact steps per app.
Does it need an account or API key?
No. The docs describe it as a remote service you reach over HTTPS with no installation and no sign-in.
Which formats can it check?
JSON, YAML and TOML. It detects the format by itself, or you can tell the tool which one you are sending.
Can it change my theme file?
No. It only checks the text you send and returns results. Your assistant has to apply any fix itself.
Does it check that segments will render correctly in my shell?
No. It checks your text against the official schema. It does not run Oh My Posh or test how a prompt looks in your terminal.
Is it free?
Yes, as far as the docs say. The hosted checker has no sign-in and no pricing mentioned, and Oh My Posh itself is open source.
Information
updated Nov 2, 2026
- Publisher
- Official
- Endpoint
https://ohmyposh.dev/api/mcp- Transport
- Streamable HTTP
- Version
- 31.8.0
- License
- MIT
- Last commit
- Oct 29, 2026
- Open issues
- 3
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 1Hide
- ohmyposh.dev · ohmyposh.dev