> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://gtm-tools.sh/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://gtm-tools.sh/_mcp/server.

# Hermes Agent

> Give Nous Research's Hermes Agent LinkedIn automation, Reddit engagement, buying signals, and verified emails, either through the official gtm-tools skill or the hosted MCP server.

## Getting started

[Hermes Agent](https://hermes-agent.nousresearch.com) is Nous Research's open-source agent, available as a CLI and a desktop app. It loads skills on demand and registers MCP tools into its normal tool registry at startup. By adding GTM Tools to Hermes, your agent gains the go-to-market data surface: buying-signal detection on any domain, LinkedIn company and people lookup, SMTP-verified email finding, and Reddit reads and writes.

There are two ways to integrate GTM Tools with Hermes: installing the official `gtm-tools` skill, or connecting the hosted MCP server.

## Option 1: Official GTM Tools Skill (Recommended)

The easiest way to add GTM capabilities to Hermes is by installing the official [`gtm-tools` skill](https://www.skills.sh/arnaudjnn/gtm-skills/gtm-tools). Hermes skills follow the same `SKILL.md` standard and load only when a turn calls for them, so a 63-tool surface costs nothing until it is used, and the skill carries the credit costs and metering rules the model needs to spend your balance sensibly.

### Installation

Install straight from the repository:

```bash
hermes skills install arnaudjnn/gtm-skills/skills/gtm-tools
```

The skills.sh form works too:

```bash
hermes skills install skills-sh/arnaudjnn/gtm-skills/gtm-tools
```

Skills land in `~/.hermes/skills/`.

### Configuration

The skill calls the API with a bearer token, so set your key in `~/.hermes/.env`:

```bash
GTM_TOOLS_API_KEY=sk_your_api_key
```

Hermes passes that through to the `execute_code` and `terminal` sandboxes, which is where the skill's `curl` calls run. Get a key with `get_api_key` or `gtm-tools admin login`. See [Getting Your API Key](/knowledge-base/getting-started/getting-api-key).

### Features

The official skill includes:

* **Buying signals:** hiring, Trustpilot sentiment, follower spikes, and tech-stack detection on any domain
* **LinkedIn lookup:** company and profile resolution from a domain or a name, employee search with boolean title filters
* **LinkedIn writes:** DMs and connection requests from your own logged-in account
* **Reddit:** thread and subreddit reads, comments, posts, votes, and DMs through Reddit Chat
* **Email:** SMTP-verified professional email finding, with a reason on every unconfirmed lookup
* **Billing:** balance, top-ups, and auto-reload, so the agent can manage its own wallet
* **Cost discipline:** the full 63-tool catalog with credit costs, the metering rules, and the error contract

### Verify installation

Check that the skill is installed:

```bash
hermes skills list
hermes skills inspect gtm-tools
```

Then invoke it in a session with its slash command, for example `/gtm-tools which of these domains are hiring SDRs`.

## Option 2: MCP Server

For typed tool schemas instead of shell calls, point Hermes at the hosted MCP server. Hermes discovers MCP servers at startup and registers their tools alongside its built-ins.

### Add the server

Add GTM Tools to `mcp_servers` in `~/.hermes/config.yaml`:

```yaml
mcp_servers:
  gtm-tools:
    url: "https://api.gtm-tools.sh/mcp"
    headers:
      Authorization: "Bearer sk_your_api_key"
    timeout: 60
    connect_timeout: 30
```

Keep `timeout` generous. `get_email` runs SMTP probes and `list_linkedin_company_employees` triggers an upstream search, so both can take tens of seconds, and a short tool-call timeout cancels work you have already been charged for.

Prefer OAuth over a static key? Omit the `headers` block and run `hermes mcp login gtm-tools`.

### Configure the server

Hermes reads MCP config at startup, so either restart it or reload in place with `/reload-mcp`.

Tools register as `mcp_<server_name>_<tool_name>`, so with the server named `gtm-tools` you get `mcp_gtm-tools_get_email` and so on. Narrow what the model sees with:

```bash
hermes mcp configure gtm-tools
```

Worth doing: 64 tools is a lot of context, and most workflows need a handful.

### Verify the server

```bash
hermes mcp
hermes tools list
```

`hermes mcp` is an interactive picker over the configured servers, and `hermes tools list` shows every registered tool, built-in and MCP.

## Example use cases

Once GTM Tools is integrated with Hermes, you can ask your agent to:

* "Score these 20 domains by buying signal and give me the top five"
* "Find the Head of Sales at acme.com and verify their email"
* "Pull the last month of LinkedIn posts from gymshark's company page"
* "Check r/sales for threads about cold email deliverability"
* "How many credits do I have left?"