> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkedcamp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Run LinkedCamp from Hermes Agent with the LinkedCamp plugin — one browser sign-in, and Hermes asks before anything changes your account.

> **[LinkedCamp plugin](https://github.com/LinkedCamp/hermes-plugin)**
>
> The LinkedCamp connection, the outreach skill, and approval prompts before every change.

> **[Hermes Agent](https://hermes-agent.nousresearch.com)**
>
> Install Hermes first if you don't have it.

The plugin talks to the same hosted server every other client uses:

```text theme={null}
https://mcp.linkedcamp.com/mcp
```

## Requirements

* Hermes Agent **0.20** or newer
* Node.js **20.18.1** or newer, with `npx` on your `PATH`. The plugin uses it to run the sign-in bridge.
* A LinkedCamp account on an active plan. See the [quick start](/mcp/quickstart.md#1-get-your-api-key) for plan requirements.

## Install

```bash theme={null}
hermes plugins install LinkedCamp/hermes-plugin --no-enable
hermes plugins enable linkedcamp
```

## Connect your account

**Sign in (recommended)**

Start a new Hermes session. The first time the plugin starts, your browser opens the LinkedCamp sign-in page. Paste your API key and approve.

Hermes keeps the token and refreshes it, so you sign in once. If the LinkedCamp tools don't appear after signing in, run `/reload-mcp`.

To sign out, delete the `~/.mcp-auth` folder.

**API key (headless)**

On a server or another machine with no browser, skip the plugin and add the server to `~/.hermes/config.yaml`:

```yaml theme={null}
mcp_servers:
  linkedcamp:
    url: "https://mcp.linkedcamp.com/mcp"
    headers:
      X-Api-Key: "${LINKEDCAMP_API_KEY}"
```

Then put your key in `~/.hermes/.env`:

```bash theme={null}
LINKEDCAMP_API_KEY=your-api-key
```

This connects LinkedCamp without the plugin's skill or approval prompts.

Your API key is in [Settings → Integrations → API](https://app.linkedcamp.com/settings/integrations?type=api).

Then ask Hermes: *"Which LinkedCamp account am I connected to?"*

> [!WARNING]
>
> Never paste your API key into a chat. The agent is told not to ask for it; if a key does end up in a conversation, rotate it in Settings → Integrations.

## Approval prompts

The plugin marks LinkedCamp as an untrusted server, so Hermes asks you before **every tool that changes something**: launching or resuming a campaign, sending a message or test email, editing a sequence, adding leads, scheduling a post, deleting records, and so on. Reading data goes through without a prompt.

In unattended runs, such as scheduled jobs, Hermes refuses those tools instead of asking, so a scheduled job can report on LinkedCamp but can't change anything.

The bundled skill also tells the agent to show you the audience and full sequence before a launch, and the exact text and recipient before a send.

## What you can do

The agent reaches the [full tool surface](/mcp/overview.md#tool-groups) your plan and permissions allow.

* Campaigns: build, generate LinkedIn and Sales Navigator audience searches, author multi-step sequences, launch after confirmation
* Leads, notes, tags and blacklists
* The unified inbox and reply drafts
* AI reply agents and knowledge bases
* LinkedIn post scheduling
* Campaign, account and funnel analytics, including [agency sub-accounts](/mcp/agencies.md)

Try:

* *"Show me my LinkedCamp account and unread inbox counts."*
* *"Build a draft campaign for heads of customer support at B2B SaaS companies. Show me the audience and the sequence before anything sends."*
* *"Summarize my campaign performance for the last 30 days."*
* *"Find my unread conversations, prioritize interested prospects and draft a reply for each. Don't send anything."*

## What it will not do

* Connect a LinkedIn account — that takes your LinkedIn password, so do it in LinkedCamp
* CRM integrations, billing, team management or API-key changes

The agent will never ask for a LinkedIn password, session cookie or verification code.

## Versions

The current release of the plugin is **1.0.0**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.