native-mcp

Connect Hermes Agent to MCP servers and auto-register discovered tools.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/photonics-dhl/Hermes --skill native-mcp-photonics-dhl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: native-mcp
Source: https://github.com/photonics-dhl/Hermes/tree/main/hermes-home/skills/mcp/native-mcp
Command: npx skills add https://github.com/photonics-dhl/Hermes --skill native-mcp-photonics-dhl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hermes Agent often needs access to tools provided by external MCP servers. This Skill provides a built-in MCP client that connects to MCP servers at startup, discovers their tools, and registers them as native Hermes Agent tools for seamless, tool-rich conversations.

Core Features & Use Cases

  • Automatic MCP server discovery on startup and runtime tool injection for all Hermes toolsets.
  • Supports stdio and HTTP transports with automatic reconnection and robust error handling.
  • Security filtering of environment variables and credential handling to prevent leakage while exposing external capabilities.
  • Use Case: Integrate a time or filesystem MCP server and call its tools directly from any conversation with Hermes.

Quick Start

Configure at least one MCP server under mcpServers in the Hermes config and restart Hermes to auto-discover and register its tools.

Frequently Asked Questions about native-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate external MCP server tools into Hermes Agent?

To integrate external MCP server tools into Hermes Agent, configure your servers under mcpServers in the Hermes config. The client connects at startup, discovers available tools, and auto-registers them as native Hermes tools for seamless access across all toolsets.

What transports are supported for connecting Hermes to MCP servers?

Hermes supports both stdio and HTTP MCP transports for connecting to external servers. It includes automatic reconnection and robust error handling to maintain reliable access to discovered tools during runtime tool injection.

Does auto-registering MCP servers in Hermes require the mcp Python package?

Yes, auto-registering MCP servers requires the mcp Python package. You must also define proper MCP server configurations under the mcpServers key in your Hermes config file before restarting the agent to trigger tool discovery.

How are credentials and environment variables handled when connecting to MCP servers?

Credentials and environment variables are processed using security filtering to prevent leakage. This mechanism securely exposes external capabilities to the Hermes Agent while protecting sensitive information during MCP server connections.

Why are my discovered MCP tools not showing up in Hermes toolsets?

Discovered MCP tools might not appear if the mcp Python package is missing or the mcpServers configuration is invalid in your Hermes config. Ensure proper server configuration and restart Hermes to trigger automatic tool discovery and injection.