wt-mcp
0.1.0-beta
{ "servers": { "wt-mcp": { "type": "stdio", "command": "dnx", "args": ["wt-mcp@0.1.0-beta", "--yes"] } } }
.vscode/mcp.json settings file.
dotnet tool install --global wt-mcp --version 0.1.0-beta
dotnet new tool-manifest
dotnet tool install --local wt-mcp --version 0.1.0-beta
#tool dotnet:?package=wt-mcp&version=0.1.0-beta&prerelease
nuke :add-package wt-mcp --version 0.1.0-beta
wt-mcp
An MCP server that helps reference and manage Windows Terminal settings and other terminal-related customizations. Built with C# and the ModelContextProtocol C# SDK.
This tool is powered by AI, which can make mistakes. Always review proposed changes before applying them.
Tools
| Tool area | What it does |
|---|---|
| Settings | Read, preview, and apply JSON Patch (RFC 6902) changes to settings.json across release channels (Stable, Preview, Canary, Dev) |
| Fragments | Create, read, update, and delete fragment extensions — portable profiles, color schemes, and actions |
| Oh My Posh | Detect installation, list/read themes, preview and apply config patches, set active theme in the PowerShell profile |
| Shell Integration | Check and configure shell integration (OSC 133 sequences, autoMarkPrompts, scrollbar marks) |
| Snippets | Manage .wt.json per-directory snippets and sendInput actions in settings or fragments |
All mutating tools follow a preview-then-apply pattern — a Preview* call returns a unified diff for the user to review, then the corresponding write call applies the change.
Setup
Add the following to your MCP configuration:
- VS Code:
<WORKSPACE>/.vscode/mcp.json - Visual Studio:
<SOLUTION>\.mcp.json
{
"servers": {
"wt-mcp": {
"type": "stdio",
"command": "dnx",
"args": ["wt-mcp", "--prerelease", "--yes"]
}
}
}
The --prerelease flag is required while wt-mcp is in beta. Once a stable version is published, users can drop it and just use ["wt-mcp", "--yes"]. To pin a specific version, use "wt-mcp@0.1.0-beta" instead.
No .NET runtime is required — the package is self-contained.
Try it out
Once configured, try asking Copilot Chat things like:
- "Change my Windows Terminal theme to Light"
- "Create a fragment with a new SSH profile"
- "What's my Oh My Posh theme? Change the git segment color to blue"
- "Set up shell integration for my terminal"
- "Add a snippet to restart the dev server in this project"
Developing locally
To run the MCP server from source, configure your IDE to use dotnet run instead of dnx:
{
"servers": {
"wt-mcp": {
"type": "stdio",
"command": "dotnet",
"args": ["run", "--project", "<PATH TO PROJECT DIRECTORY>"]
}
}
}
This requires the .NET 10 SDK. See the VS Code or Visual Studio MCP docs for more details.
Publishing to NuGet.org
dotnet pack -c Release
dotnet nuget push bin/Release/*.nupkg --api-key <your-api-key> --source https://api.nuget.org/v3/index.json
Package metadata is configured in wt-mcp.csproj and the server declaration in .mcp/server.json.
More information
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0-beta | 52 | 3/13/2026 |