# Oh My Posh

> Oh My Posh is the most customizable and fastest prompt theme engine for any shell. It renders
> beautifully themed terminal prompts displaying Git status, language versions, cloud context,
> system metrics and more — 117 segments in all — on Windows, macOS, and Linux.

## Docs

- [Docs hub](/docs/) — Getting started landing page, linking to installation and shell setup
- [Windows Installation](/docs/installation/windows) — winget, chocolatey, or manual install
- [macOS Installation](/docs/installation/macos) — Homebrew or MacPorts
- [Linux Installation](/docs/installation/linux) — curl install script
- [Shell Setup](/docs/installation/prompt) — per-shell init snippets
- [Fonts](/docs/installation/fonts) — install a Nerd Font for icons
- [Themes Gallery](/docs/themes) — browse all bundled themes
- [Configuration Reference](/docs/configuration/introduction) — full JSON/YAML/TOML schema
- [Segments Reference](/docs/segments/overview) — all 117 available segments, searchable and filterable by category and setup
- [Studio](/docs/studio) — edit a config and see the prompt render live in the browser
- [FAQ](/docs/faq) — common issues and solutions

## Skills

Agent-ready installation and configuration guides:

- [Oh My Posh skill root](/skills/ohmyposh/SKILL.md) — overview and navigation
- [Install on Windows](/skills/ohmyposh/installation/windows.md)
- [Install on macOS](/skills/ohmyposh/installation/macos.md)
- [Install on Linux](/skills/ohmyposh/installation/linux.md)
- [Shell setup — PowerShell](/skills/ohmyposh/shell/powershell.md)
- [Shell setup — Bash](/skills/ohmyposh/shell/bash.md)
- [Shell setup — Zsh](/skills/ohmyposh/shell/zsh.md)
- [Shell setup — Fish](/skills/ohmyposh/shell/fish.md)
- [Shell setup — Nu](/skills/ohmyposh/shell/nu.md)
- [Shell setup — Cmd (Clink)](/skills/ohmyposh/shell/cmd.md)
- [Shell setup — Elvish](/skills/ohmyposh/shell/elvish.md)
- [Shell setup — Xonsh](/skills/ohmyposh/shell/xonsh.md)
- [Configuration & themes](/skills/ohmyposh/configuration.md)

## MCP

Oh My Posh exposes an MCP (Model Context Protocol) endpoint for validating prompt configurations:

- `POST /api/mcp` — JSON-RPC 2.0; supports tools/list, tools/call, initialize
- `GET /api/mcp` — returns server info and available tools
- Tools: `validate_config` (full config), `validate_segment` (individual segment)
- Formats: JSON, YAML, TOML (auto-detected)
- Discovery: `/.well-known/mcp.json`

## Examples

Detect current shell:

```bash
oh-my-posh get shell
```

Validate a config via MCP:

```bash
curl -X POST https://ohmyposh.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"validate_config","arguments":{"content":"{\"version\":3}","format":"json"}},"id":1}'
```
