MCP (Model Context Protocol)
MCP lets Hermes Agent connect to external tool servers so the agent can use tools that live outside Hermes itself — GitHub, databases, file systems, browser sta
MCP lets Hermes Agent connect to external tool servers so the agent can use tools that live outside Hermes itself — GitHub, databases, file systems, browser stacks, internal APIs, and more. If you have ever wanted Hermes to use a tool that already exists somewhere else, MCP is usually the cleanest way to do it. 1. …
What this page covers
- What MCP gives you
- Quick start
- Catalog: one-click install for Nous-approved MCPs
- Tool selection at install time
- Trust model
- Manifest version compatibility
- Runtime ${ENVVAR} substitution
- Updating tool selection later
- Updating the catalog manifest
- Two kinds of MCP servers
- Stdio servers
- HTTP servers
- OAuth-authenticated HTTP servers
- mTLS / client certificates
- Basic configuration reference
- Common keys
- Minimal stdio example
- Minimal HTTP example
- Built-in presets
- How Hermes registers MCP tools
- MCP utility tools
- Important
- Per-server filtering
- Disable a server entirely
- Whitelist server tools
- Blacklist server tools
- Precedence rule
- Filter utility tools too
- Full example
- What happens if everything is filtered out?
- Runtime behavior
- Discovery time
- Dynamic Tool Discovery
- Reloading
- Toolsets
- Security model
- Stdio env filtering
- Config-level exposure control
- Example use cases
- GitHub server with a minimal issue-management surface
- Stripe server with dangerous actions removed
- Filesystem server for a single project root
- Troubleshooting
- MCP server not connecting
- Tools not appearing
- Why didn't resource or prompt utilities appear?
- Parallel Tool Calls
- MCP Sampling Support
- Running Hermes as an MCP server
- When to use this
- Quick start
- MCP client configuration
- Available tools
- Event system
- Options
- How it works
- Current limits
- 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 Core Features
Features Overview
Hermes Agent includes a rich set of capabilities that extend far beyond basic chat. From persistent memory and file aware context to browser automation and voic
Tools & Toolsets
Tools are functions that extend the agent's capabilities. They're organized into logical toolsets that can be enabled or disabled per platform. Available Tools
Skills System
Skills are on demand knowledge documents the agent can load when needed. They follow a progressive disclosure pattern to minimize token usage and are compatible
Curator
The curator is a background maintenance pass for agent created skills . It tracks how often each skill is viewed, used, and patched, moves long unused skills th
Persistent Memory
Hermes Agent has bounded, curated memory that persists across sessions. This lets it remember your preferences, your projects, your environment, and things it h
Memory Providers
Hermes Agent ships with 8 external memory provider plugins that give the agent persistent, cross session knowledge beyond the built in MEMORY.md and USER.md. On