Overview
Configures Hermes Desktop Agent to use Scavio's MCP server for search grounding instead of its built-in web scraper. Verifies the connection, tests tool discovery, and validates search results.
Trigger
One-time setup (run once per Hermes installation)
Schedule
One-time setup
Workflow Steps
Locate Hermes config file
Find the Hermes Desktop Agent configuration file (typically ~/.hermes/config.json or similar).
Add MCP server entry
Add Scavio's MCP server URL and API key to the mcp_servers array in the config file.
Restart Hermes
Restart the Hermes Desktop Agent to pick up the new MCP server configuration.
Verify tool discovery
In Hermes, check that Scavio's tools (google_search, reddit_search, youtube_search, etc.) appear in the available tools list.
Test search grounding
Ask Hermes a question that requires current web data. Verify that it uses the Scavio MCP tool instead of the built-in web scraper.
Disable built-in search
Optionally disable Hermes's built-in web search to force all search queries through the MCP server for consistent results.
Python Implementation
import json, os
config_path = os.path.expanduser("~/.hermes/config.json")
with open(config_path) as f:
config = json.load(f)
config.setdefault("mcp_servers", [])
config["mcp_servers"].append({
"name": "scavio-search",
"url": "https://mcp.scavio.dev/mcp",
"headers": {"x-api-key": os.environ["SCAVIO_API_KEY"]}
})
with open(config_path, "w") as f:
json.dump(config, f, indent=2)
print("Scavio MCP server added to Hermes config")
print("Restart Hermes to activate")JavaScript Implementation
import fs from "fs";
import path from "path";
const configPath = path.join(os.homedir(), ".hermes", "config.json");
const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
config.mcp_servers = config.mcp_servers || [];
config.mcp_servers.push({
name: "scavio-search",
url: "https://mcp.scavio.dev/mcp",
headers: {"x-api-key": process.env.SCAVIO_API_KEY}
});
fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
console.log("Scavio MCP server added. Restart Hermes to activate.");Platforms Used
Web search with knowledge graph, PAA, and AI overviews
Community, posts & threaded comments from any subreddit
YouTube
Video search with transcripts and metadata