Integrations

Hermes Agent

GTM Tools' Hermes Agent integration

Getting started

Hermes Agent 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.

The easiest way to add GTM capabilities to Hermes is by installing the official gtm-tools skill. 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 token costs and metering rules the model needs to spend your balance sensibly.

Installation

Install straight from the repository:

$hermes skills install arnaudjnn/gtm-skills/skills/gtm-tools

The skills.sh form works too:

$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:

$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.

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 token costs, the metering rules, and the error contract

Verify installation

Check that the skill is installed:

$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:

1mcp_servers:
2  gtm-tools:
3    url: "https://api.gtm-tools.sh/mcp"
4    headers:
5      Authorization: "Bearer sk_your_api_key"
6    timeout: 60
7    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:

$hermes mcp configure gtm-tools

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

Verify the server

$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 tokens do I have left?”