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

# Set up Hermes for link building

> Connect Hermes to AgentLinkOps with OAuth, load the maintained skills, and prepare a campaign or saved-link report before scheduling work.

Give Hermes a [Link Builder or Link Monitor role](https://docs.agentlinkops.com/guides/agent-roles.md) for one website or a portfolio. Use an existing Hermes installation and an authorized AgentLinkOps workspace.

## 1. Connect with OAuth

Add this entry to `mcp_servers` in `~/.hermes/config.yaml`, preserving your other servers:

```yaml theme={null}
mcp_servers:
  agentlinkops:
    url: "https://app.agentlinkops.com/mcp/all"
    auth: oauth
```

Then run from a fresh terminal:

```bash theme={null}
hermes mcp login agentlinkops
hermes chat
```

Complete browser sign-in and review the workspace access. Keep passwords and codes in the sign-in window. Hermes manages OAuth discovery and stored tokens. See [Hermes MCP setup](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp).

Ask the agent to call `get_workspace` and `list_projects`. Check that it names the intended workspace and websites. If no website exists, [add one first](https://docs.agentlinkops.com/guides/get-started-app.md). Follow the returned [connection recovery](https://docs.agentlinkops.com/guides/connect-mcp.md#reconnect-after-a-failure) instructions if authorization fails.

## 2. Save the job and skills

Copy your [role prompt](https://docs.agentlinkops.com/guides/agent-roles.md) into Hermes and ask it to save the agreed role and separate site briefs. Have it read `https://agentlinkops.com/SKILL.md` and follow its current installation instructions for Hermes. Loading a web reference does not install a local skill. Verify the maintained skills appear in Hermes before relying on them in later sessions.

Continue with the role's [first campaign or saved-link report](https://docs.agentlinkops.com/guides/agent-roles.md#start-with-one-result). Connect a sender only for Link Builder; use [sender handoff](https://docs.agentlinkops.com/guides/crm-sender-handoff.md) for existing campaigns.

## 3. Schedule the proven task

After reviewing an ad hoc result, agree cadence, timezone, report destination and sending authority. Ask Hermes to inspect existing jobs, then propose the schedule. Attach the required skills so each fresh scheduled session receives them.

The Hermes gateway must be running for scheduled agent jobs; a sleeping or offline host cannot provide local execution. Check `hermes cron status` and inspect execution history after the first due run. See [Hermes scheduled tasks](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron).

This path follows Hermes documentation reviewed November 15, 2026. We have not yet tested this AgentLinkOps OAuth setup or a scheduled campaign in Hermes. [Compare agent setup paths](https://docs.agentlinkops.com/guides/ai-agents.md).


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