mcphub-operator

Original：🇺🇸 English

Translated

4 scripts

Operate MCPHub groups, endpoints, compression, and CLI from repo registry. Use for hub preflight, group picking, tunnel vs local exposure. NOT harness sync.

5installs

Sourcewyattowalsh/agents

Added on2026-08-19

NPX Install

npx skill4agent add wyattowalsh/agents mcphub-operator

SKILL.md Content

View Translation Comparison →

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

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

bash

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
```

mcphub-operator

NPX Install

Tags

SKILL.md Content

MCPHub Operator

Dispatch

Operator Contract

`preflight`

`groups`

`compression`

`tunnel`

`cli`

Maintainer Loop

References