McpOrchestrator MCP server

<!-- mcp-name: io.github.Byggarepop/dotnet-mcp-orchestrator -->

McpOrchestrator — a .NET-native MCP orchestrator

Every MCP server you connect costs context before the agent does anything — its tool manifests sit in the prompt on every turn. McpOrchestrator puts one server between your agent and all the others and loads downstream tool manifests on demand, so the agent's always-on context stays flat no matter how many servers you add. The agent sees three meta-tools — listcapabilities → discovertools → route — and the orchestrator is a pure relay: it forwards exactly what the agent sends, never interpreting it. It can also serve Agent Skills with the same on-demand discipline.

See it in 70 seconds

https://github.com/user-attachments/assets/741c1afa-4bef-4870-9b84-e2c245b8117e

Measured impact

Against a real workplace MCP setup, measured with the Copilot CLI's /usage:

The savings scale with the number of servers. Measure your own setup first — one command, nothing installed, not a single file changed (needs the .NET SDK):

cd ~/my-project          # a folder with a .mcp.json / .vscode/mcp.json / Cursor config
dotnet tool execute McpOrchestrator profile

Quick start

From an existing MCP setup, cd to the folder holding your host config (.mcp.json, .vscode/mcp.json, or a Cursor config) and run:

dotnet tool execute McpOrchestrator --yes init      # dnx McpOrchestrator --yes init  works too

It lifts your stdio servers into a generated orchestrator.config.json, backs up the host config, and rewrites it to launch only the orchestrator. The generated catalog looks like this — one entry per downstream server:

{
  "capabilities": [
    {
      "name": "files",
      "summary": "Read and search files under the project root.", // auto-generated
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:/projects"]
    }
    // …one entry per server init found
  ]
}

The summary line is what the agent routes on — refine any that read poorly. Restart your MCP host and you're done: the agent discovers everything on its own through listcapabilities → discovertools → route, and every later edit to this file hot-reloads without a restart.

Add a skill

A skill is a folder with a SKILL.md — instructions the agent discovers and follows by itself when a task matches. Create one:

my-skills/
└── release-notes/
    └── SKILL.md

---
name: release-notes
description: Writes user-facing release notes from a git commit range. Use when asked for release notes or a changelog entry.
---

1. Collect the commits since the last release tag.
2. Group by user impact; drop internal-only changes.
3. One sentence per change, present tense.

Point the orchestrator at the folder in orchestrator.config.json:

"skills": {
  "sources": [{ "id": "local", "type": "directory", "path": "C:/my-skills" }]
}

Shortened. The full README is on GitHub.