# Connect Hermes Agent

> **Release status.** The hosted endpoint, OAuth, dynamic client registration, curated operator tools and the send permission are live. Masheev is submitted to the Hermes MCP catalog and in review; until it is listed, add the server by hand as below.

## From the catalog

Once Masheev is listed, run `hermes mcp` and choose **masheev**, or pick it in the desktop app's MCP catalog. Hermes signs you in with OAuth; no configuration is needed.

## Add the server

In `~/.hermes/config.yaml`:

```yaml
mcp_servers:
  masheev:
    url: "https://api.masheev.com/api/agents/mcp"
    auth: oauth
```

Then:

```bash
hermes mcp login masheev               # browser sign-in
hermes mcp login masheev --flow device # headless hosts
hermes mcp test masheev
```

Start a new session or run `/reload-mcp`. Masheev registers Hermes through dynamic client registration, so no `client_id` is needed. To narrow the tools, add `tools: { include: [find_conversations, get_conversation, draft_reply, confirm_send] }`.

## Skills

Add the Masheev skills repository as a tap:

```bash
hermes skills tap add masheev/skills
hermes skills search masheev
```

Skills carry `metadata.hermes` tags. The CLI skill only shows when the terminal toolset is available.

## Safety

Customer text arrives as `untrusted_customer_content`. Replies are drafted with `draft_reply` and sent with `confirm_send` only after a human approves. Billing, irreversible deletes and credentials are unavailable.

See [Connect an agent](https://docs.masheev.com/agents.md) for permissions and revocation.