Hermes Agent is the 2026 open-source agent framework that ships as a self-hosted binary with MCP tool support. This tutorial registers Scavio as a Hermes MCP tool so the agent gains live multi-surface search.
Prerequisites
- Hermes Agent installed
- A Scavio API key
- A Hermes config file (hermes.yaml)
Walkthrough
Step 1: Locate the Hermes config
Hermes reads tools from hermes.yaml in the project directory.
Bash
cat hermes.yaml || touch hermes.yamlStep 2: Add the Scavio MCP block
Hermes accepts HTTP MCP endpoints directly.
tools:
- name: scavio
type: mcp
endpoint: https://mcp.scavio.dev/mcp
headers:
x-api-key: ${SCAVIO_API_KEY}Step 3: Reload Hermes
Hermes re-reads config on restart.
Bash
hermes restartStep 4: Verify tool discovery
Hermes lists all MCP tools on startup.
Bash
hermes tools list | grep scavioStep 5: Test with a fresh-data query
Ask something that requires live search.
Bash
hermes run 'summarize the latest Hermes Agent release notes and recent community posts'Python Example
Python
# Hermes Agent does not require Python glue for MCP tools.
# Direct API parity check:
import requests, os
API_KEY = os.environ['SCAVIO_API_KEY']
r = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': API_KEY},
json={'query': 'hermes agent 2026 release'})
print(r.json().get('organic_results', [])[:3])JavaScript Example
JavaScript
// MCP config-first; direct API parity:
const API_KEY = process.env.SCAVIO_API_KEY;
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ query: 'hermes agent 2026 release' })
});
console.log(((await r.json()).organic_results || []).slice(0, 3));Expected Output
JSON
Hermes prints scavio as an available tool and calls it automatically for queries that need fresh data.