---
title: "Hermes Agent MCP: connect Leadsets B2B data"
description: "Connect Leadsets to Hermes Agent over remote MCP or REST to search people and companies, enrich contacts, verify work emails and run GTM skills."
canonical: https://www.leadsets.ai/integrations/hermes-agent
updated: 2026-11-09
---

# Using Leadsets with Hermes Agent over MCP

Leadsets lists Hermes Agent as a supported personal agent, connected through the Leadsets remote MCP server (https://mcp.leadsets.ai) plus free GTM skills. Once connected, Hermes Agent can call eight Leadsets tools: search_people, search_companies, enrich_person, enrich_company, verify_email, scrape_company, scrape_jobs and get_usage. Leadsets does not publish Hermes-specific setup steps, so you use its generic remote MCP setup or the REST API.

## What Hermes Agent can do with Leadsets

Hermes Agent is a personal AI agent that Leadsets lists among the personal agents it supports. The Leadsets integrations page describes the connection as **MCP server + skills**: the agent reaches Leadsets data through the remote MCP server, and free SKILL.md playbooks teach it GTM workflows.

Through that connection, the agent gets the same eight tools every MCP client gets:

- `search_people`: find people by title, function, seniority, location, company size and industry, with a match reason on every result.
- `search_companies`: find accounts by industry, headcount band, technology and location.
- `enrich_person`: current role, company and a verified work email when one exists.
- `enrich_company`: firmographics for a domain, with source and freshness on every field.
- `verify_email`: a label of verified, catch-all, unknown or invalid, with a confidence score.
- `scrape_company` and `scrape_jobs`: a homepage turned into products and positioning, or a careers page turned into open roles with dates.
- `get_usage`: what is left in the current window and week, at no cost.

Results come back as structured JSON with match reasons, verification status, confidence and the date each field was last checked, so the agent can decide what to trust before it hands you a list.

## How to connect Leadsets to Hermes Agent

The Leadsets docs do not publish setup steps specific to Hermes Agent. What follows is the generic remote MCP and REST setup from the [MCP connection docs](https://www.leadsets.ai/docs/mcp). Use whichever method your Hermes Agent setup supports; Leadsets does not document menus or settings inside Hermes Agent.

1. **Get a key.** Create a free Leadsets account and copy your key from the dashboard. Keys start with `ls_live_` and should be kept server-side. The free plan gives 1,000 records once, with no card.
2. **Add the remote MCP server.** The server URL is `https://mcp.leadsets.ai`. It is a remote server, so nothing is installed or run locally. The docs show two authentication patterns: Claude signs in with OAuth (no key to paste), while Cursor adds a server named `leadsets` with that URL and an `Authorization` header of `Bearer ls_live_…`. If your client asks for a header, use the second pattern.
3. **Check the connection.** Ask the agent: "What's my Leadsets usage?" If it calls `get_usage` and answers with your remaining balance, you are connected.
4. **Add skills.** Leadsets publishes 50 free, MIT-licensed playbooks for any agent that reads the SKILL.md standard. Clone the library with `git clone github.com/leadsets/leadsets-skills` and browse them in the [skills library](https://www.leadsets.ai/skills). Each skill says which tools to call, in what order, and how to check the result.
5. **Or call REST directly.** If you prefer HTTP requests, every tool is also an endpoint at `https://api.leadsets.ai/v1` with a bearer key, for example `POST /v1/people/search`. TypeScript and Python SDKs are available (`npm i @leadsets/sdk`, `pip install leadsets`), with idempotency keys, cursor pagination and Retry-After headers.
6. **Get the list out.** Leadsets exports CSV for any sequencer, works with Google Sheets through skills, and pushes lists into LinkedCamp campaigns.

## Example workflow: hiring signals to a send-ready list

Maya Chen runs revenue operations at Northwind Analytics (northwind.co) and wants timely outbound targets. She gives her agent one plain-language brief: "Find US B2B SaaS companies with 20 to 200 people hiring SDRs in the last 30 days. Get their revenue leaders with verified work emails and put catch-alls in a separate file."

A typical run, following the pattern Leadsets shows on its site, looks like this:

1. `get_usage` to check what is left in the five-hour and weekly windows before starting.
2. `search_companies` with the size, country and industry filters to build the account list.
3. `scrape_jobs` on each careers page to confirm open SDR roles and their posting dates. This uses scrape units, which are a paid add-on.
4. `search_people` for revenue leaders at VP level and above at the confirmed accounts, each with match reasons.
5. `enrich_person` for each person, which returns emails already verified, or `verify_email` on any addresses Maya already had.
6. Export to CSV, with verified contacts in one file and catch-all addresses in another to send at lower volume.

The [build an outbound prospect list](https://www.leadsets.ai/skills/build-outbound-prospect-list) skill packages a similar sequence, and the hiring signal skills cover the `scrape_jobs` step.

## What to watch for

- **Records and requests are counted separately.** A record counts only when data comes back, so an empty search uses none. Every call counts as a request, and the request limit is five times the record allowance. Details are in [limits and costs](https://www.leadsets.ai/docs/limits).
- **Free records are one time.** The 1,000 free records are shared across search and enrichment and do not refill. When they run out, the API returns `402 free_records_exhausted` and the agent should ask you to upgrade rather than retry.
- **Windows roll.** Paid plans have limits per rolling five hours and per week. Solo at $29 a month allows 1,000 enrichments and 500 search records per five hours. Over a limit, the API returns `429` with a Retry-After time, and the blocked call counts against nothing. Too many searches at once returns `429 too_many_concurrent`.
- **Read the email labels.** Verified means the mailbox accepts mail. Catch-all means the domain accepts everything, so no one can confirm the mailbox. Unknown means the server gave no clear answer. Invalid addresses are never served as contacts. See [how verification works](https://www.leadsets.ai/verify).
- **Scraping is not on Free.** `scrape_company` and `scrape_jobs` need scrape units on a paid plan: $9 for 1,000, $19 for 5,000 or $49 for 20,000. One unit is one standard page.
- **Use idempotency keys over REST** so retries never count records twice.

## What this integration does not do

- **No phone numbers.** Leadsets does not offer them yet. If calling is central to your outreach, a provider that sells phone data is a better fit today.
- **Not a CRM or a sending tool.** Leadsets feeds HubSpot, Salesforce, Pipedrive, Attio and sequencers such as Instantly and Smartlead; it does not send email itself.
- **Business data only.** No consumer data, no sensitive categories and no personal home addresses. US personal emails are available on paid plans and count toward enrichment limits.
- **No logged-in scraping.** Scraping reads public company pages only and respects robots signals.
- **No SOC 2 report yet.** SOC 2 Type I is planned with a target of Q3 2027.
- **No Hermes-specific documentation.** Leadsets lists Hermes Agent as supported but documents only the generic MCP and REST setup above.

## Questions and answers

### How do I connect Hermes Agent to an MCP server for B2B data?

Add the Leadsets remote MCP server URL, https://mcp.leadsets.ai, using whatever method your Hermes Agent setup supports for remote MCP servers. Leadsets does not publish Hermes-specific steps, so follow its generic MCP docs. Confirm the connection by asking the agent for your Leadsets usage.

### Do I need an API key to use Leadsets with Hermes Agent?

It depends on how your client authenticates. The Leadsets docs show Claude signing in with OAuth and Cursor using an Authorization header with a bearer key that starts with ls_live_. A free key comes with 1,000 one-time records and no card.

### Which Leadsets tools can Hermes Agent use?

All eight: search_people, search_companies, enrich_person, enrich_company, verify_email, scrape_company, scrape_jobs and get_usage. The scraping tools need scrape units on a paid plan, and get_usage costs nothing.

### Can Hermes Agent use Leadsets skills?

Leadsets lists Hermes Agent with MCP server plus skills. The 50 free, MIT-licensed SKILL.md playbooks can be cloned from github.com/leadsets/leadsets-skills and teach an agent workflows such as building a prospect list or cleaning a list before sending.

### What happens if my agent hits a Leadsets limit mid-run?

Leadsets returns a 429 with a Retry-After time, and the blocked call counts against nothing. The agent can call get_usage before a big run and split the job or submit an async job if it would cross a window.

### Does Leadsets give Hermes Agent phone numbers?

No. Leadsets returns work emails, US personal emails on paid plans, roles and company data, and does not offer phone numbers yet. It says it will only add them once sourcing rights and costs are clear.

---

Leadsets · https://www.leadsets.ai · Site index: https://www.leadsets.ai/llms.txt