skills.rest
elderbernardi
elderbernardiCOMMUNITY
Explore all skills by this author →
GitHub

excrtx-integrate-mcp

Install, configure, and test MCP servers in the Hermes runtime.

1|Updated May 26, 2026
Search Tags:#troubleshooting#integration#cli#configuration#mcp#yaml#hermes
One-click install
npx skills add https://github.com/elderbernardi/exocortex.saas --skill excrtx-integrate-mcp-elderbernardi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: excrtx-integrate-mcp
Source: https://github.com/elderbernardi/exocortex.saas/tree/main/skills/excrtx-integrate-mcp
Command: npx skills add https://github.com/elderbernardi/exocortex.saas --skill excrtx-integrate-mcp-elderbernardi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Adding MCP servers to the Hermes agent runtime often fails due to CLI argument-parsing bugs, YAML serialization issues, and missing tool discovery, leaving servers configured but unusable. ## Core Features & Use Cases - Guided Installation & Configuration: Walks through inspecting a server's README, installing via pip/pipx/npm, and registering it with Hermes over stdio or HTTP transports. - CLI Workarounds: Provides a Python/YAML fallback for the known hermes mcp add --args argparse bug and the hermes config set string-serialization issue. - Testing & Activation: Verifies connectivity with hermes mcp test and explains why tools only appear after a gateway or CLI restart. - Use Case: Add the Wikipedia MCP server with --country BR arguments, fix the config with the Python YAML script, and confirm 22 discovered tools after restart. ## Quick Start Add the Wikipedia MCP server to Hermes with country set to BR, work around any CLI argument errors, and verify the connection with hermes mcp test.

Frequently Asked Questions about excrtx-integrate-mcp

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

FAQPage Schema
How do I add an MCP server to Hermes?▼

Install the server package with pip, pipx, or npm, then run hermes mcp add <name> --command <command> for stdio servers or hermes mcp add <name> --url for HTTP servers. Verify with hermes mcp test <name> and restart the gateway or CLI session so tools are discovered.

Why does hermes mcp add fail with unrecognized arguments?▼

The Hermes CLI parses arguments with argparse, so flags like --country BR are consumed as Hermes CLI flags instead of being passed to the MCP server. Work around it by setting the command with hermes config set and fixing args via a Python YAML script.

Why are MCP tools not showing up after configuration?▼

MCP tool discovery happens only at agent startup, so configuration changes require a restart. Use /restart in the gateway chat or exit and start a new hermes chat session, after which tools appear as mcp_<server>_<tool>.

Does hermes config set work for MCP args and env variables?▼

hermes config set stores args and env values as YAML string literals rather than lists or dictionaries, which breaks loading. Fix the config.yaml with a Python script using yaml.safe_load and yaml.dump to write proper list and dict structures.

What should I check when hermes mcp test fails?▼

For command not found errors, confirm the binary is in PATH with which <command>. For connection timeouts, increase connect_timeout, and for no tools discovered, check the server logs since it started but exposed no tools.

Related Skills

Explore More Software Engineering Skills→
ZESCODEZESCODE

search-first

Search package registries and MCP servers before writing custom code.

Community
Intermediate
jpoutrinjpoutrin
14

agent-tools

Configure Claude Code agent tool permissions with path and command restrictions.

Community
Basic
zaiyemeiyou404zaiyemeiyou404

native-mcp

Connect Hermes Agent to MCP servers and invoke their tools.

Community
Advanced
RasaHQRasaHQ
5

rasa-calling-mcp-tools-from-flows

Call MCP tools from Rasa flow steps with input and output mappings.

Official
Intermediate