# ViewsMax setup brief: Hermes Agent

Four lines of config give Hermes Agent the ViewsMax toolset — publishing, offer tracking, sales reporting and outlier research — with a browser login the first time it connects.

MCP endpoint: https://api.viewsmax.com/api/mcp. Full docs: https://viewsmax.com/ai.md. Human version of this page: https://viewsmax.com/hermes.

## 1. Link the accounts you publish to

Sign up for ViewsMax, go to Dashboard → Connections, and link each channel. The platform logins happen inside ViewsMax, so your AI only ever holds a ViewsMax permission — and new channels you add later show up for it straight away.

## 2. Plug ViewsMax into Hermes Agent

- **Edit your Hermes config.** Add ViewsMax under mcp_servers in ~/.hermes/config.yaml.
  ```
  mcp_servers:
    viewsmax:
      url: "https://api.viewsmax.com/api/mcp"
      auth: oauth
  ```
- **Log in.** Start Hermes. The first time it connects to ViewsMax it shows a sign-in link (and opens your browser when it can). Log in to ViewsMax, pick Full access or Read-only, and press Approve.

- **Headless server?.** Generate an API key in ViewsMax under Settings → AI Assistant Access and send it as a header in place of auth: oauth.
  ```
  mcp_servers:
    viewsmax:
      url: "https://api.viewsmax.com/api/mcp"
      headers:
        Authorization: "Bearer vmx_YOUR_KEY"
  ```

## 3. Run a quick test

> Show me five outlier videos from the ViewsMax featured feed and say in one line why each one over-performed.

Got two accounts on the same platform? Name the one you mean ("my @brand Instagram") so your AI doesn't have to stop and ask.

## 4. Give it a real job

> Ask me my niche, then find this month's top YouTube outliers in it through ViewsMax, break down why the best one worked, and save it to my library.

What happens next:

- Before it uses a ViewsMax tool that changes something, Hermes Agent asks for your OK.
- Outlier research reads a shared database, so it works before you've connected a single channel; anything it saves lands in your ViewsMax library.
- Posts are stored as drafts or queued for the time you gave. At publish time ViewsMax sends to each channel separately and keeps a result per platform, so one failure never blocks the rest.

## Channels

- YouTube: One video. You'll be asked whether it goes out public, unlisted or private.
- TikTok: A video or a photo set. You'll be asked to pick the privacy level.
- Instagram: One photo or one Reel, on an Instagram Business or Creator account.
- X: Text, with up to 4 images. No video yet.
- LinkedIn: Text, with one image. No video yet.
- Threads: Text, with one image or one video.
- Bluesky: Text, with up to 4 images. No video yet.

## Prompts to try

- **Borrow what's working:** Pull YouTube outliers in personal finance from this month and explain the hook behind the top three. Save the best one to my library.
- **Queue a post:** Put this on my LinkedIn and Bluesky for Thursday at 8:30am my time: "Our free content calendar template is out — grab it from the link in my bio."
- **Cross-post a clip:** Take the video at https://example.com/reel.mp4 and make it an Instagram Reel and a TikTok draft. Give TikTok a shorter caption than Instagram.
- **Track a promotion:** I'm promoting my ebook at https://example.com/ebook. Set it up as an offer with sales as the goal, and make separate tracked links for YouTube and Instagram.
- **Find your best earner:** Rank my offers by revenue for the past 30 days and tell me which traffic source is actually converting.
- **Tidy the queue:** What's going out this weekend? Push anything on X back by two hours.

## Fixes

- **Hermes lost its ViewsMax login.** Run hermes mcp login viewsmax to sign in again. Hermes keeps the login in ~/.hermes/mcp-tokens/ and renews it on its own until that fails.
- **No ViewsMax tools in the list.** Make sure ViewsMax is switched on for the conversation you're in, then open a fresh one. Still missing? Remove ViewsMax and connect it again.
- **Reads work, but posting is refused.** The connection was approved as read-only. Reconnect and pick full access on the ViewsMax approval screen, or swap in a full-access API key.
- **Media won't upload.** Uploading a file into the chat window isn't enough — ViewsMax downloads media from a link. Host the file at a public https address that serves the file itself, not a preview page. Accepted: JPEG, PNG, WebP, GIF, MP4, MOV.
- **A channel isn't listed.** Link it under Dashboard → Connections in ViewsMax (your AI can also hand you a connect link), then run the test prompt again.
- **One platform published, another didn't.** Each platform is published separately in the background and keeps its own status. Ask for the status of that post to see the exact error the platform sent back.