MCPHub Operator
Repo-managed MCPHub control plane: workflow groups, bearer endpoints, optional compression, ChatGPT tunnel policy. Smart Routing stays off in tracked config.
NOT for: editing the agent-stack sync script, live skills-sync apply installs, or PostgreSQL/pgvector smart-routing setup (use maintainer OpenSpec + explicit user request).
Dispatch
$ARGUMENTS |
Action |
| (empty) |
Show group picker summary, preflight command, and reference index |
preflight / doctor |
Run bash scripts/preflight.sh from skill dir; stop on fail |
groups / picker |
Load references/group-picker.md |
compression |
Load references/compression-opt-in.md |
tunnel |
Explain ChatGPT tunnel group-only policy + .env.mcphub tunnel vars |
cli |
Load references/cli-cheatsheet.md |
Operator Contract
preflight
- From repo root (or pass
--cwd to bundled doctor), run:
bash skills/mcphub-operator/scripts/preflight.sh
- Stop when JSON
ok is false or any check with status: fail touches settings parity, smart routing, or client profiles.
- Treat
warn as advisory (hub not running, bearer unset locally).
groups
- Default local harnesses attach
harness only, with per-server endpoints available but disabled by default.
- Treat
harness as the smallest high-signal set for context-bloat control: Brave Search, DuckDuckGo Search, DDGS (metasearch/news), Context7, DeepWiki, llms.txt catalog (llms-txt-explorer list_websites only), Fetch, and package metadata. Use check_website only via opt-in workflow groups. Prefer DDGS snippets; avoid fetch_full_content unless the user needs full pages.
- Use
daily for routine opt-in expansion; use coding, research, review, or release for scoped agentic dev flows.
- Escalate to capability groups (
web-search, web-read, docs, repo, browser, media, notebooks, data, design, productivity, accounts, references) when the task needs that surface.
- Use
reasoning only for hard problems; keep reasoning-lab experimental.
- Attach account-backed, live-browser (Chrome DevTools and Scrapling headless scrape sessions), heavy, or experimental groups only with explicit user intent.
- Never attach
tunnel to local harness configs unless testing the remote consumer shape.
compression
- Tracked
mcp_settings.json keeps toolResultCompression.enabled: false.
- Opt-in locally via
.env.mcphub only after user approves; see compression reference.
- Disable compression when debugging structured tool JSON or investigating truncation.
tunnel
- ChatGPT remote MCP uses
tunnel group only (https://mcp.w4w.dev/mcp/tunnel when tunnel enabled).
- Do not widen ChatGPT to the global
/mcp route or per-server endpoints without explicit user request.
- Tunnel credentials stay in
.env.mcphub / ~/.cloudflared/ — never commit.
cli
- Prefer repo recipes:
just mcphub-generate, just mcphub-generate-check, just mcphub-validate, just mcphub-doctor, just mcphub-smoke.
- Use upstream MCPHub CLI for live hub inspection when the process is running; see CLI reference.
Maintainer Loop
just mcphub-generate
just mcphub-generate-check
just mcphub-validate
uv run python skills/mcphub-operator/scripts/check.py
Regenerate settings after editing config/mcp-registry.json groups or servers.
References
- Group picker
- CLI cheat sheet
- Compression opt-in
- Public maintainer doc:
docs/ai-tools/mcphub.md
1---2name: mcphub-operator3description: Operate MCPHub groups, endpoints, compression, and CLI from repo registry. Use for hub preflight, group picking, tunnel vs local exposure. NOT harness sync.4license: MIT5---67# MCPHub Operator89Repo-managed MCPHub control plane: workflow groups, bearer endpoints, optional compression, ChatGPT tunnel policy. Smart Routing stays **off** in tracked config.1011**NOT for:** editing the agent-stack sync script, live skills-sync apply installs, or PostgreSQL/pgvector smart-routing setup (use maintainer OpenSpec + explicit user request).1213## Dispatch1415| `$ARGUMENTS` | Action |16| --- | --- |17| *(empty)* | Show group picker summary, preflight command, and reference index |18| `preflight` / `doctor` | Run `bash scripts/preflight.sh` from skill dir; stop on `fail` |19| `groups` / `picker` | Load [references/group-picker.md](references/group-picker.md) |20| `compression` | Load [references/compression-opt-in.md](references/compression-opt-in.md) |21| `tunnel` | Explain ChatGPT `tunnel` group-only policy + `.env.mcphub` tunnel vars |22| `cli` | Load [references/cli-cheatsheet.md](references/cli-cheatsheet.md) |2324## Operator Contract2526### `preflight`27281. From repo root (or pass `--cwd` to bundled doctor), run:2930```bash31bash skills/mcphub-operator/scripts/preflight.sh32```33342. Stop when JSON `ok` is false or any check with `status: fail` touches settings parity, smart routing, or client profiles.353. Treat `warn` as advisory (hub not running, bearer unset locally).3637### `groups`38391. Default local harnesses attach **`harness`** only, with per-server endpoints available but disabled by default.402. Treat **`harness`** as the smallest high-signal set for context-bloat control: Brave Search, DuckDuckGo Search, DDGS (metasearch/news), Context7, DeepWiki, llms.txt catalog (`llms-txt-explorer` `list_websites` only), Fetch, and package metadata. Use `check_website` only via opt-in workflow groups. Prefer DDGS snippets; avoid `fetch_full_content` unless the user needs full pages.413. Use **`daily`** for routine opt-in expansion; use **`coding`**, **`research`**, **`review`**, or **`release`** for scoped agentic dev flows.424. Escalate to capability groups (`web-search`, `web-read`, `docs`, `repo`, `browser`, `media`, `notebooks`, `data`, `design`, `productivity`, `accounts`, `references`) when the task needs that surface.435. Use **`reasoning`** only for hard problems; keep **`reasoning-lab`** experimental.446. Attach account-backed, **live-browser** (Chrome DevTools and Scrapling headless scrape sessions), heavy, or experimental groups only with explicit user intent.457. Never attach **`tunnel`** to local harness configs unless testing the remote consumer shape.4647### `compression`48491. Tracked `mcp_settings.json` keeps `toolResultCompression.enabled: false`.502. Opt-in locally via `.env.mcphub` only after user approves; see compression reference.513. Disable compression when debugging structured tool JSON or investigating truncation.5253### `tunnel`54551. ChatGPT remote MCP uses **`tunnel`** group only (`https://mcp.w4w.dev/mcp/tunnel` when tunnel enabled).562. Do not widen ChatGPT to the global `/mcp` route or per-server endpoints without explicit user request.573. Tunnel credentials stay in `.env.mcphub` / `~/.cloudflared/` — never commit.5859### `cli`60611. Prefer repo recipes: `just mcphub-generate`, `just mcphub-generate-check`, `just mcphub-validate`, `just mcphub-doctor`, `just mcphub-smoke`.622. Use upstream MCPHub CLI for live hub inspection when the process is running; see CLI reference.6364## Maintainer Loop6566```bash67just mcphub-generate68just mcphub-generate-check69just mcphub-validate70uv run python skills/mcphub-operator/scripts/check.py71```7273Regenerate settings after editing `config/mcp-registry.json` groups or servers.7475## References7677- [Group picker](references/group-picker.md)78- [CLI cheat sheet](references/cli-cheatsheet.md)79- [Compression opt-in](references/compression-opt-in.md)80- Public maintainer doc: `docs/ai-tools/mcphub.md`
wyattowalsh