hermes - 💡(How to fix) Fix Docs request: iFlow Search MCP server configuration for Hermes Agent

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

I would like to propose adding a Hermes Agent docs example for using iFlow Search through MCP.

The MCP server has been published as:

  • Package: @iflow-ai/search-mcp@next
  • Binary: iflow-search-mcp
  • Transport: stdio
  • Config: environment variables only

It exposes three tools:

  • iflow_web_search
  • iflow_image_search
  • iflow_web_fetch

Root Cause

I would like to propose adding a Hermes Agent docs example for using iFlow Search through MCP.

The MCP server has been published as:

  • Package: @iflow-ai/search-mcp@next
  • Binary: iflow-search-mcp
  • Transport: stdio
  • Config: environment variables only

It exposes three tools:

  • iflow_web_search
  • iflow_image_search
  • iflow_web_fetch

Code Example

mcp_servers:
  iflow-search:
    command: npx
    args:
      - -y
      - "@iflow-ai/search-mcp@next"
    env:
      IFLOW_API_KEY: YOUR_IFLOW_API_KEY

---

hermes mcp test iflow-search
RAW_BUFFERClick to expand / collapse

Summary

I would like to propose adding a Hermes Agent docs example for using iFlow Search through MCP.

The MCP server has been published as:

  • Package: @iflow-ai/search-mcp@next
  • Binary: iflow-search-mcp
  • Transport: stdio
  • Config: environment variables only

It exposes three tools:

  • iflow_web_search
  • iflow_image_search
  • iflow_web_fetch

Project information

Hermes config

This has been tested successfully with Hermes using ~/.hermes/config.yaml:

mcp_servers:
  iflow-search:
    command: npx
    args:
      - -y
      - "@iflow-ai/search-mcp@next"
    env:
      IFLOW_API_KEY: YOUR_IFLOW_API_KEY

Verification command:

hermes mcp test iflow-search

Verified behavior

Hermes was able to:

  • start the MCP server through npx -y @iflow-ai/search-mcp@next
  • discover all three tools
  • call web search successfully
  • call image search successfully
  • call web fetch successfully

No JSON-RPC parse errors, stdout pollution, server disconnects, or command failures were observed.

Important note

IFLOW_API_KEY must be configured in the server env block. It should not be committed to a repository.

Request

Would the Hermes maintainers be open to a docs PR adding this as an MCP server example?

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING