> For the complete documentation index, see [llms.txt](https://docs.talordata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talordata.com/serp-api/integration/mcp-integration/hermes-agent-integration/hermes-mcp-integration.md).

# Hermes MCP Integration

Connect Hermes Agent to TalorData SERP MCP to give your agent access to real-time, structured public search results. TalorData can support web research, news monitoring, local business discovery, product and price research, SEO visibility checks, and other SERP-backed workflows.

## Prerequisites

Before you begin, make sure that you have:

* A TalorData account with an active SERP API key.
* A Hermes Agent installation that can add an MCP server.
* Access to the Hermes Agent configuration file.

{% stepper %}
{% step %}

## Get your TalorData API key

Sign in to the [TalorData dashboard](https://www.talordata.com/) and create or copy a SERP API key.

{% hint style="warning" %}
Keep this key private. It is used in the MCP server URL and consumes quota from your TalorData SERP API plan.
{% endhint %}
{% endstep %}

{% step %}

## Open the Hermes configuration file

Open the Hermes configuration file:

* Linux, macOS, or WSL2: `~/.hermes/config.yaml`
* Native Windows: `%LOCALAPPDATA%\hermes\config.yaml`

If the file does not exist, run `hermes` once to complete the initial setup, then open the file again.
{% endstep %}

{% step %}

## Add TalorData SERP MCP

Add one of the following entries to your MCP client configuration, replacing `YOUR_USER_TOKEN` with your own token.

{% tabs %}
{% tab title="Method 1: Recommended — use the header" %}
Suitable for MCP clients that support custom headers.

```json
{
  "mcpServers": {
    "talordata": {
      "url": "https://mcp.talordata.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_USER_TOKEN"
      }
    }
  }
}
```

{% endtab %}

{% tab title="Method 2: Use a path token" %}
Use this method when headers are not supported.

```json
{
  "mcpServers": {
    "talordata": {
      "type": "http",
      "url": "https://mcp.talordata.net/YOUR_API_TOKEN/mcp"
    }
  }
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Use only one method. If your configuration already includes `mcpServers`, add only the `talordata` entry beneath it. Do not create a second `mcpServers` section or replace existing server entries.
{% endhint %}
{% endstep %}

{% step %}

## Verify the connection

Start a new Hermes Agent session and send a request such as:

```
Use TalorData SERP to find the five most recent news articles about AI agents.
Return the title, publisher, publication time, source URL, and a one-sentence summary for each result.
```

When the connection is working, Hermes Agent should call a TalorData search tool and return live results with source URLs. The exact available tools and result types depend on your TalorData plan and the selected search engine.
{% endstep %}
{% endstepper %}

## Example prompts

{% tabs %}
{% tab title="Market research" %}

```
Use TalorData SERP to compare the top five competitors for AI meeting assistants in the United States.
Include company name, positioning, pricing signals, and source links.
```

{% endtab %}

{% tab title="News monitoring" %}

```
Use TalorData SERP to find news published in the last 24 hours about OpenAI.
Group the results by topic and include the original article URLs.
```

{% endtab %}

{% tab title="Local business research" %}

```
Use TalorData SERP to find highly rated coworking spaces in Austin, Texas.
Return the business name, rating, review count, address, website, and source link.
```

{% endtab %}

{% tab title="SEO visibility check" %}

```
Use TalorData SERP to check the Google search results for "AI agent platform" in the United States.
Identify whether example.com appears in the organic results and report its ranking position.
```

{% endtab %}
{% endtabs %}

## What TalorData SERP MCP can help Hermes Agent do

TalorData SERP MCP provides structured, real-time public search data across supported engines and result types, including:

* Web, news, image, and video search
* Local and map results
* Shopping and product research
* SEO rank and competitor analysis
* Google Finance, Flights, Hotels, Jobs, Scholar, Trends, Patents, and Google Play results where supported
* Google, Bing, Yandex, and DuckDuckGo search workflows where supported

Ask Hermes Agent to preserve source links and clearly state the search country, language, freshness window, and other query conditions when they matter to the result.

## Troubleshooting

<details>

<summary>TalorData tools do not appear</summary>

Confirm that the URL contains a valid TalorData API key, the YAML indentation is valid, and the `talordata_serp` entry is nested under `mcp_servers`. Save the configuration and restart Hermes Agent.

</details>

<details>

<summary>Authentication or quota error</summary>

Create a new SERP API key in the TalorData dashboard if the existing key is invalid or disabled. Check your plan and remaining quota before retrying the request.

</details>

<details>

<summary>The search result is empty</summary>

An empty result is not necessarily an integration error. Try a broader query, another country or language, or a different supported result type.

</details>

<details>

<summary>A requested search type fails</summary>

Some search types require specific parameters, such as a location, date range, image URL, or target domain. Ask Hermes Agent to use a supported TalorData SERP result type and provide the required query conditions.

</details>

## Security and usage notes

* Do not paste your TalorData API key into prompts, shared screenshots, public repositories, or client-side code.
* Use TalorData only for public search result data and comply with applicable laws, platform terms, and your internal data-use policies.
* Search results are time- and location-sensitive. Keep source URLs and query conditions in reports that require traceability.