Connect Intura MCP to Hermes Agent: AI Visibility and Website Audits from Chat

How do you connect Intura MCP to Hermes Agent?

1. 1

   Copy your API key from the dashboard

   Open Integrations → MCP in the Data AI Search dashboard and copy your API key. The page also shows a full server URL with the key already in it, which is fine for the Claude app but not what you want here: in Hermes you keep the key and the URL apart. Treat the key like a password. Anyone who has it can read the workspace and run audits that spend its credits.

2. 2

   Save the key in ~/.hermes/.env

   Add the key to ~/.hermes/.env as INTURA_API_KEY. Hermes resolves ${VAR} placeholders in config.yaml from your environment and this file, so the config can name the key without containing it. That keeps the key out of a config file you might paste into a chat, share with a teammate or commit to a dotfiles repo. If the variable is missing, Hermes keeps the placeholder as literal text and the server answers with an authentication error, which is the first thing to check when step 4 fails.

   echo 'INTURA_API_KEY=paste_your_key_here' >> ~/.hermes/.env

3. 3

   Add the server under mcp_servers in config.yaml

   Open ~/.hermes/config.yaml and add an intura entry with a url and nothing else. The key goes in the URL as ?api_key=, not in a header. This is the step people get wrong: the Hermes docs show remote servers authenticating with headers: Authorization: Bearer, and copying that pattern fails here, because the Intura server reads a Bearer header as an older login token, not as your workspace key. The server speaks Streamable HTTP, which Hermes uses for a url entry by default, so no transport line is needed.

   mcp_servers:
     intura:
       url: "https://api.dataaisearch.com/mcp?api_key=${INTURA_API_KEY}"

4. 4

   Reload and test the connection

   Type /reload-mcp in a running Hermes chat, or run hermes mcp test intura from the terminal. Hermes prefixes every MCP tool with the server name, so the Intura tools show up as mcp_intura_ followed by the tool name: mcp_intura_audit_list_website_audits, mcp_intura_category_get_questions and so on. If the test fails with an authentication error, the key did not resolve or was copied wrong; go back to step 2. If tools list fine but a call comes back with a credits message, the workspace balance is below 1.

   hermes mcp test intura
   
   # or, inside a running chat
   /reload-mcp

5. 5

   Decide which tools the agent may call

   Use the tools.exclude list in the server entry to hide the tools that spend real credits until you trust how the agent uses them. Every Intura tool call costs 1 credit, except five that charge what the same action costs in the dashboard: creating an AI Visibility project, adding prompts to it, running prompts, starting a Website Audit and re-running an audit with AI analysis. An agent asked to "check our visibility" can decide a fresh run is the best way to check. Excluding those five keeps the first week read-only in practice; remove them from the list when you want the agent to start runs for you.

6. 6

   Ask a first question and check which tool ran

   Start with a question that can only be answered from your workspace, such as listing your AI Visibility projects, and watch the tool calls in the Hermes output. If no mcp_intura_ call appears, the agent answered from its own knowledge and the numbers are made up. Guide three in the series covers this habit in more depth; it applies to every MCP server, not just this one.

   List my AI Visibility projects with their latest mention rate. Use the Intura tools only, and tell me which tool you called.

What can Hermes Agent do with the Intura MCP server?

Copy-ready config and prompts

mcp_servers:
  intura:
    url: "https://api.dataaisearch.com/mcp?api_key=${INTURA_API_KEY}"
    tools:
      exclude:
        - audit_create_ai_visibility_project
        - audit_add_ai_visibility_prompts
        - audit_run_ai_visibility_prompts
        - audit_start_website_audit
        - audit_rerun_website_audit

Using the Intura tools, get the latest AI Visibility report for <project>. Give me the mention rate and citation rate per AI engine, the three buyer questions where we are not mentioned at all, and the top open next action. Quote the numbers exactly as the tool returned them.

In my latest Website Audit for <domain>, list the open problems on /pricing. I have fixed them. Re-check that page only, wait for the result, and tell me which problems are gone and which remain.

For the top 10 queries in Search Console for sc-domain:example.com over the last 28 days, check the Intura Category Overview for matching consumer questions. Which of those questions do AI engines answer without mentioning us?

Frequently asked questions about Intura MCP and Hermes Agent