MCP Server Install Sequence

From browsing the Hub (or manual config) to the server appearing as Available in the UI

User browser MCP Page Switch UI Hermes Agent port 8642 ~/.hermes/ config.yaml alt [install method] [Hub] 1a. Browse Hub / search servers filter by name or category [Manual] 1b. Click Manual Install enter command, args, env vars 2. Show server config form command, args, env vars, trust level 3. Confirm & click Install confirmation dialog accepted 4. POST /api/mcp/install server name, command, args, env 5. Write server entry to config.yaml mcp_servers.<name>: {command, args, env} 6. Register server probe on next restart / reload 7. Poll GET /api/mcp/status UI refreshes server list 8. Return server list + status installed: true • connected: false 9. Server appears as "Available" ready to connect — see Connecting MCP servers browse form confirm POST write register poll available Transport cyan = Switch UI ↔ Agent emerald = Agent internal violet = storage write slate = user action

Hub install path

  • • Browse Hub tab, search by name or category
  • • Click entry to see description, config, trust level
  • • Click Install → confirm dialog
  • • Server added to agent config automatically

Manual install path

  • • Click Manual Install, enter command + args + env vars
  • • OR edit ~/.hermes/config.yaml directly under mcp_servers:
  • • Restart the agent after manual config edits
  • • Server appears in list on next page load

After install

  • • Server shows status "Available" (installed, not yet connected)
  • • Installation does not start the server process
  • • Go to MCP → server row → toggle to connect
  • • See Connecting MCP servers for the handshake flow

Hermes Switch UI • MCP install sequence • Hub browse / manual config → agent write → Available