Use MCP with Hermes
This guide shows how to actually use MCP with Hermes Agent in day to day workflows. If the feature page explains what MCP is, this guide is about how to get val
This guide shows how to actually use MCP with Hermes Agent in day-to-day workflows. If the feature page explains what MCP is, this guide is about how to get value from it quickly and safely. Use MCP when: Do not use MCP when: Think of MCP as an adapter layer: That last part matters. …
What this page covers
- When should you use MCP?
- Mental model
- Step 1: install MCP support
- Step 2: add one server first
- Step 3: verify MCP loaded
- Step 4: start filtering immediately
- Example: whitelist only what you want
- WSL2: bridge Hermes in WSL to Windows Chrome
- Why this mode is useful
- Recommended server
- Typical prompt
- When /browser connect is the wrong tool
- Known pitfalls
- Example: blacklist dangerous actions
- Example: disable utility wrappers too
- What does filtering actually affect?
- Utility wrappers you may see
- Common patterns
- Pattern 1: local project assistant
- Pattern 2: GitHub triage assistant
- Pattern 3: internal API assistant
- Pattern 4: documentation / knowledge servers
- Tutorial: end-to-end setup with filtering
- Phase 1: add GitHub MCP with a tight whitelist
- Phase 2: expand only when needed
- Phase 3: add a second server with different policy
- Safe usage recommendations
- Prefer allowlists for dangerous systems
- Disable unused utilities
- Keep servers scoped narrowly
- Reload after config changes
- Troubleshooting by symptom
- "The server connects but the tools I expected are missing"
- "The server is configured but nothing loads"
- "Why do I see fewer tools than the MCP server advertises?"
- "How do I remove an MCP server without deleting the config?"
- Recommended first MCP setups
- Related docs
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Guides & Tutorials
Tips & Best Practices
A quick wins collection of practical tips that make you immediately more effective with Hermes Agent. Each section targets a different aspect — scan the headers
Run Local LLMs on Mac
This guide walks you through running a local LLM server on macOS with an OpenAI compatible API. You get full privacy, zero API costs, and surprisingly good perf
Tutorial: Daily Briefing Bot
Tutorial: Build a Daily Briefing Bot In this tutorial, you'll build a personal briefing bot that wakes up every morning, researches topics you care about, summa
Tutorial: Team Telegram Assistant
Set Up a Team Telegram Assistant This tutorial walks you through setting up a Telegram bot powered by Hermes Agent that multiple team members can use. By the en
Using Hermes as a Python Library
Hermes isn't just a CLI tool. You can import directly and use it programmatically in your own Python scripts, web applications, or automation pipelines. This gu
Use Voice Mode with Hermes
This guide is the practical companion to the Voice Mode feature reference. If the feature page explains what voice mode can do, this guide shows how to actually