Hermes Agent Integration

Hermes Agent is an open-source AI Agent framework with MCP protocol support.

Configuration Steps

1. Locate the Hermes configuration file: ~/.hermes/config.yaml

2. Add the sentinel configuration in the mcp_servers section:

Local stdio Mode (pip install)

If you have installed sentinel-mcp-server via pip install -e .:

mcp_servers:
  sentinel:
    command: python
    args: ["-m", "sentinel_mcp.server"]
    env:
      SENTINEL_API_BASE: "https://priceminder.online/api/v1"
      SENTINEL_TOKEN: "YOUR_TOKEN"
    enabled: true

Local stdio Mode (uvx, no pip install required)

mcp_servers:
  sentinel:
    command: uvx
    args: ["sentinel-mcp-server"]
    env:
      SENTINEL_API_BASE: "https://priceminder.online/api/v1"
      SENTINEL_TOKEN: "YOUR_TOKEN"
    enabled: true

Field	Description
command	Use python (pip mode) or uvx (no-install mode)
args	Use ["-m", "sentinel_mcp.server"] for pip mode, ["sentinel-mcp-server"] for uvx mode
SENTINEL_API_BASE	API address
SENTINEL_TOKEN	Your user Token
enabled	Set to true to enable

3. Restart Hermes Agent

Verification

In Hermes interactive mode, enter /tools. You should see the following 10 tools (prefix mcp__sentinel__):

mcp__sentinel__get_monitor_list
mcp__sentinel__get_price_summary
mcp__sentinel__get_price_history
mcp__sentinel__get_alerts
mcp__sentinel__add_monitor
mcp__sentinel__update_monitor_status
mcp__sentinel__mark_alert_read
mcp__sentinel__get_crawl_health
mcp__sentinel__get_monitor_overview
mcp__sentinel__search_my_products

Or run in the command line:

hermes mcp list

FAQ

Issue	Cause	Solution
/tools doesn't show sentinel tools	MCP Server not loaded	Check config.yaml configuration, run /reload-mcp
Tool returns "SENTINEL_TOKEN not set"	env not passed in	Confirm env.SENTINEL_TOKEN is written correctly
Tool returns 401 Unauthorized	Token invalid	Use a valid Token
Tool returns 500	API endpoint not deployed	Confirm backend API is deployed with latest version
command not found: python	Python not in PATH	Use full path like C:\Python313\python.exe
ModuleNotFoundError: sentinel_mcp	Package not installed	Re-run pip install -e . or switch to uvx mode
Hermes startup hangs	MCP Server startup timeout	Manually test with python -m sentinel_mcp.server

Tool Filtering

If you want to expose only some tools, use the allow-list configuration:

mcp_servers:
  sentinel:
    command: uvx
    args: ["sentinel-mcp-server"]
    env:
      SENTINEL_API_BASE: "https://priceminder.online/api/v1"
      SENTINEL_TOKEN: "YOUR_TOKEN"
    enabled: true
    # Only expose query-type tools
    tool_filter:
      allow:
        - get_monitor_list
        - get_price_summary
        - get_price_history
        - get_alerts