II · my story · why this matters
I was you. Then I built this.
Before
Wiring MCPs into Hermes was a nightmare.
I'd hand-edit ~/.hermes/config.yaml.
I'd guess at the exact command and args for each server.
I'd hunt for API keys, paste them into .env, hope I didn't typo a path.
OAuth servers? Spent an hour the first time figuring out PKCE and refresh-token flows.
And every time I wanted to enable or disable a tool, I'd drop back to the terminal.
Then PR #30870 landed — and I wired the catalog into my Agent OS dashboard.
After
Now I open the Hermes section of my dashboard.
The MCPs panel shows every catalog entry with its status — available / installed / enabled.
Click any row → install begins → credentials prompt → checklist of tools to enable.
OAuth flows pop a browser. PKCE, refresh, step-up auth — handled.
Enable, disable, uninstall — one toggle. No terminal.
Time to wire a new MCP: 30 seconds.
You can have this too. Same merge. Same dashboard. Same free.
Before you scroll on —
Commit to transitioning today. Not tomorrow.
You've seen the proof above. Real members. Real MCPs wired in. Already happening.
The next 10 minutes show exactly how the new MCP catalog works — and how I wired it into the Hermes section of Agent OS as a one-click panel.
So here's the deal.
If you're reading this — promise yourself one thing right now. You're going to finish this guide AND install your first catalog MCP before you sleep tonight. Just one. n8n. Linear. GitHub. Whatever fits your workflow. Because the moment you make this transition, your whole tool stack stops being scattered across separate apps and starts being orchestrated by Hermes.
The people sitting still are still hand-editing config.yaml. The people switching today are clicking install buttons inside their dashboards.
Be one of those people.
Commit to the transition. Commit to wiring one catalog MCP today. This changes everything about how your tools connect.
IV · the framework
The Goldie MCP Hub™.
Five layers that turn the new Hermes catalog into a dashboard-native superpower.
Each layer is a benefit you feel the moment it's wired in. Together they're what makes the difference between "MCPs exist somewhere in my config file" and "MCPs are a panel in my dashboard I actually use every day."
Clone → Probe → Checklist → Install. Four stations of the catalog flow.
i.
Catalog — Nous-approved one-click.
Hermes now ships a curated list of MCP servers reviewed and merged by Nous staff. n8n, Linear, GitHub, Stripe, more on the way. You don't pick from an open community submission queue — every entry passed a PR review. You stop guessing which MCPs are safe. The catalog already vetted them.
ii.
Picker — interactive install UI.
Run hermes mcp for the interactive picker, hermes mcp catalog for a scriptable list, hermes mcp install n8n for one-shot. Or — better — open my Agent OS dashboard and click. You stop hand-editing config.yaml. The picker handles every edit safely.
iii.
Probe — auto-discover tools.
After credentials are configured, Hermes probes the MCP server to list every tool it exposes. Then it shows you a checklist. Some tools come pre-checked from the manifest's safe defaults; mutating tools (delete_workspace, etc.) come unchecked. You stop blindly granting full access. You pick the tools you actually want.
iv.
Auth — OAuth handled for you.
API keys get written to ~/.hermes/.env automatically. OAuth servers (Linear, Sentry, Atlassian, Asana, Figma, Stripe) trigger the browser, handle discovery + dynamic client registration + PKCE + token exchange + refresh. You stop reading OAuth specs. The catalog runs the dance for you.
v.
Hub — inside Agent OS.
I wired the whole catalog into the Hermes section of my Agent OS dashboard. New panel: MCPs. Left side: catalog browser with status badges (available / installed / enabled). Right side: your currently installed servers with toggles and uninstall buttons. You stop dropping to the terminal. The whole catalog lives next to Chat / Goal Mode / Workspace.
VI · my agent os build
And I just wired it into my Agent OS.
The CLI is great. The dashboard panel is better.
The moment PR #30870 merged, I started building Phase 1 of an MCPs panel inside the Hermes section of my Agent OS dashboard. New tab sits alongside Chat / Goal Mode / Workspace / Control Room.
Here's what's in Phase 1 (shipped this week):
- Left column · Catalogue browser — lists every entry from
hermes mcp catalog with status badges (available / installed / enabled / disabled), descriptions, and a click-through to the source repo on GitHub.
- Right column · Installed servers — your currently active servers pulled from
~/.hermes/config.yaml. Each has a toggle to enable/disable and a button to uninstall.
- API routes wired —
/api/hermes/mcp/catalog (read), /api/hermes/mcp/status (read installed), /api/hermes/mcp/toggle (flip enabled flag), /api/hermes/mcp/uninstall (shell to CLI).
- YAML editing — uses
js-yaml (10KB library) to read and modify config.yaml safely, preserving comments and key ordering.
- Auto-reload coordination — after any toggle, a slash command equivalent fires
/reload-mcp on the running Hermes daemon so the change takes effect without a restart.
Phase 2 (next session): one-click install with a credentials modal — pre-collect API keys in a form, write to .env, run hermes mcp install <name> non-interactively. OAuth servers stream stdout to the UI so you can complete the browser flow without dropping to the terminal.
Phase 3 (optional): per-tool checkbox UI mirroring the CLI's probe-and-checklist flow — fine-grained control of tools.include from the dashboard.
The catalog as a curated cabinet. Each box vetted. Each one ready to install.
"The CLI was the engine. The dashboard panel is the cockpit."
XIV · why inside agent os
Why this matters more inside Agent OS.
The catalog is great on its own. The catalog + my Agent OS dashboard panel is a different category of useful.
a.
Shared status across every panel.
When you enable an MCP from the dashboard, Hermes auto-reloads. Goal Mode immediately has access to the new tool. Workspace immediately shows outputs from it. Mission Control immediately shows the MCP's status alongside every other agent. You don't restart anything. The whole dashboard updates in place.
b.
One cockpit for all servers.
MCPs sit next to Chat / Goal Mode / Workspace / Control Room. You don't switch apps to manage tools — you switch tabs. Tool management stops being a separate workflow. It's part of the dashboard.
c.
Catalog + custom MCPs in the same view.
Picker unification means Nous-approved catalog entries AND your own user-added MCPs both show in the dashboard panel. Catalog ones marked [catalog], custom ones marked [user-added]. One UI. Both kinds. No mental context-switch.
d.
The bill stays zero.
The catalog is free. Hermes is free. The Agent OS panel I built is free. The only costs are the underlying MCP servers themselves (most are free; some like Linear use OAuth into your existing paid account).
The infrastructure cost of MCP onboarding goes to zero. The MCPs themselves are bring-your-own-credentials.
The catalog is the engine.
The panel is the cockpit.
Agent OS is the chassis that turns them into a vehicle you actually drive.
Thinking it?
"I'll just use the CLI — I don't need a dashboard panel."
You can. And in two weeks you'll be opening the panel anyway.
Once you have more than 2-3 MCPs wired, the dashboard panel becomes the natural place to see "what's installed, what's enabled, what's available." The CLI is great for one-off installs. The panel is great for ongoing management.
Both work. The dashboard is the long-term win.
Use the CLI for the first install. Use the panel forever after.
✓
Members who tried the CLI alone first all opened the dashboard panel within their first week of running 3+ MCPs.
XV · the voice in your head
Three beliefs holding you back.
✕ "MCPs are only for developers."
That was true before the catalog. Now the install is one click, the credentials are prompted, and OAuth is handled. You don't need to know what PKCE is to wire Linear into Hermes.
✓ MCPs are now for operators, not just developers.
If you can pick a row in a list and click "install" — you can wire an MCP. That's the bar.
✕ "I don't need MCPs — Hermes can already do everything."
Hermes is great. But you'll hit the moment when you want it to drive your Linear project tracking, or your n8n workflows, or your GitHub repo ops. That's the moment MCPs stop being optional.
✓ MCPs are how Hermes reaches everything outside Hermes.
Every new MCP is a new surface Hermes can act on. The catalog now makes onboarding new surfaces a 30-second job instead of a 30-minute one.
✕ "I'll wait until the catalog has more entries."
Day-one catalog already covers the highest-value targets — n8n (workflow automation), Linear (project tracking), GitHub (repo ops), more being merged regularly. Plus your custom user-added MCPs work alongside the catalog ones.
✓ The catalog is already worth installing today.
The 2-3 entries you'd use right now justify the install. The catalog growing is a bonus, not a prerequisite.
Don't take my word for it
258 real members already broke through these beliefs. Their wins — real integrations, real automation, real time saved — are documented here.
Read the 158-page testimonials doc →