# Oh My Posh Configurator (npm · ohmyposh-configurator)

MCP server for creating, validating, and exporting Oh My Posh terminal prompt configurations.

- Trust score: 83/100 (high trust)
- Change this week: +7
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-12

## Components

- npm · `ohmyposh-configurator`: 83/100 (this document), [markdown](https://verifymcp.io/servers/jamesmontemagno-ohmyposh-configurator/ohmyposh-configurator.md), [page](https://verifymcp.io/servers/jamesmontemagno-ohmyposh-configurator/ohmyposh-configurator)

## Channel facts

- Registry: `npm`
- Package: `ohmyposh-configurator`
- Version: `1.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-12.

- **Supply Chain Security**: 99/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 34 of 155 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 84/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to jamesmontemagno/ohmyposh-configurator).
  - License check failed: no license is declared.
  - Actively maintained (last published 8 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 87/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1000 tokens (~52/item across 19 items; 13 tools + 6 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (85% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add jamesmontemagno-ohmyposh-configurator -- npx -y ohmyposh-configurator
```

### Codex

```bash
codex mcp add jamesmontemagno-ohmyposh-configurator -- npx -y ohmyposh-configurator
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jamesmontemagno-ohmyposh-configurator": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "ohmyposh-configurator"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add jamesmontemagno-ohmyposh-configurator --command npx --arg -y --arg ohmyposh-configurator
```

### Hermes

```yaml
mcp_servers:
  jamesmontemagno-ohmyposh-configurator:
    command: "npx"
    args: ["-y", "ohmyposh-configurator"]
```

### Other

```json
{
  "mcpServers": {
    "jamesmontemagno-ohmyposh-configurator": {
      "command": "npx",
      "args": [
        "-y",
        "ohmyposh-configurator"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-12 (score 83, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-11 (score 82, +4)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-08-07 (score 78, +2)

- [security improvement] Known CVEs: partial → pass
- [functional] Dependency health: partial → 0.90

### 2026-08-04 (score 76)

First indexed and scored.

## MCP tools (13)

### `create_configuration` (~102 tokens)

Create a new Oh My Posh configuration from a natural language description. Generates a complete configuration with blocks, segments, and smart defaults.

Input parameters:

- `description` (string, required): Natural language description of the desired prompt (e.g., "developer prompt with git and python")
- `segments` (array): Optional list of segment types to include (e.g., ["path", "git", "python"])
- `style` (string): Style for all segments (default: powerline)

Output parameters:

- `config` (object)

### `add_segment` (~132 tokens)

Add a segment to an existing Oh My Posh configuration with smart defaults. Automatically applies appropriate colors, templates, and options based on segment type.

Input parameters:

- `blockIndex` (number): The index of the block to add the segment to (default: 0)
- `config` (string, required): The existing Oh My Posh configuration as JSON string
- `segmentType` (string, required): The type of segment to add (e.g., "git", "python", "aws")
- `style` (string): Style for the segment (default: powerline)
- `template` (string): Optional custom template for the segment

Output parameters:

- `config` (object)

### `modify_configuration` (~79 tokens)

Modify an existing Oh My Posh configuration. Can update global settings, add/remove blocks, modify segments, or change colors and templates.

Input parameters:

- `config` (string, required): The existing Oh My Posh configuration as JSON string
- `modifications` (object, required): Object describing the modifications to make (e.g., {"final_space": false, "palette": {...}})

Output parameters:

- `config` (object)

### `validate_configuration` (~46 tokens)

Validate an Oh My Posh configuration for correctness. Checks required fields, structure, and palette references.

Input parameters:

- `config` (string, required): The Oh My Posh configuration to validate as JSON string

Output parameters:

- `validation` (object)

### `export_configuration` (~64 tokens)

Export an Oh My Posh configuration in different formats (JSON, YAML, TOML). Automatically cleans internal IDs and ensures proper formatting.

Input parameters:

- `config` (string, required): The Oh My Posh configuration as JSON string
- `format` (string): Output format (default: json)

Output parameters:

- `format` (string)
- `output` (string)

### `list_segments` (~62 tokens)

List all available Oh My Posh segments with their descriptions, categories, and default settings. Can filter by category or search by keyword.

Input parameters:

- `category` (string): Filter segments by category
- `search` (string): Search segments by name, type, or description

Output parameters:

- `segments` (array)

### `get_segment_info` (~50 tokens)

Get detailed information about a specific segment type including properties, options, and template variables.

Input parameters:

- `segmentType` (string, required): The segment type to get information about (e.g., "git", "python")

Output parameters:

- `segment` (object)

### `list_sample_configs` (~19 tokens)

List all available sample configurations with descriptions and tags.

Output parameters:

- `configs` (array)

### `load_sample_config` (~33 tokens)

Load a specific sample configuration by ID.

Input parameters:

- `configId` (string, required): The ID of the sample configuration to load

Output parameters:

- `config` (object)
- `metadata` (object)

### `search_ohmyposh_docs` (~96 tokens)

Get links to the official Oh My Posh documentation at https://ohmyposh.dev/docs/ for a given topic. Returns documentation URLs and guidance for segments, configuration options, templates, and features.

Input parameters:

- `query` (string, required): Search query (e.g., "git segment options", "powerline symbols", "color templates")
- `topic` (string): Optional: Narrow search to a specific documentation topic

### `get_ohmyposh_segment_docs` (~70 tokens)

Get the official Oh My Posh documentation for a specific segment type. Returns detailed information from https://ohmyposh.dev/docs/segments/

Input parameters:

- `segmentType` (string, required): The segment type to get documentation for (e.g., "git", "python", "aws")

### `get_ohmyposh_cli_status` (~34 tokens)

Check whether Oh My Posh is installed locally for this MCP server and return its version when available.

Output parameters:

- `available` (boolean)
- `reason` (string)
- `version` (string)

### `render_live_preview` (~92 tokens)

Explicitly render an Oh My Posh configuration with the locally installed Oh My Posh CLI. This evaluates the configuration against the local environment and returns terminal ANSI output for the MCP preview app.

Input parameters:

- `acknowledgeRisk` (boolean, required): Must be true to confirm that rendering executes the local Oh My Posh CLI against this configuration.
- `config` (string, required): The Oh My Posh configuration to render as a JSON string

Output parameters:

- `available` (boolean)
- `output` (string)
- `reason` (string)
- `version` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/jamesmontemagno-ohmyposh-configurator/ohmyposh-configurator#diagnostics

## Score history

- 2026-08-12: 83
- 2026-08-11: 82
- 2026-08-10: 78
- 2026-08-09: 78
- 2026-08-08: 78
- 2026-08-07: 78
- 2026-08-06: 76
- 2026-08-05: 76
- 2026-08-04: 76

## Links

- npm package: https://www.npmjs.com/package/ohmyposh-configurator
- Socket report: https://socket.dev/npm/package/ohmyposh-configurator
- Repository: https://github.com/jamesmontemagno/ohmyposh-configurator
- Website: https://configurator.ohmyposh.dev/
- Changelog RSS feed: https://verifymcp.io/servers/jamesmontemagno-ohmyposh-configurator/ohmyposh-configurator.xml
- Changelog JSON feed: https://verifymcp.io/servers/jamesmontemagno-ohmyposh-configurator/ohmyposh-configurator.json
- HTML version of this page: https://verifymcp.io/servers/jamesmontemagno-ohmyposh-configurator/ohmyposh-configurator