# ViewsMax setup brief: Cursor

Keep coding while Cursor's Agent handles the announcement: it drafts and schedules posts, builds tracked links, pulls your offer numbers, and finds outlier videos in your niche through ViewsMax.

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

## 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 Cursor

- **Generate an API key.** In ViewsMax, open Settings → AI Assistant Access and create a key — full access to publish, read-only for reporting. It begins with vmx_ and is only displayed once.
- **Add it to Cursor.** Save this in ~/.cursor/mcp.json so every project can use ViewsMax, then restart Cursor. A project-level .cursor/mcp.json works too — just keep a file containing your key out of git.
  ```
  {
    "mcpServers": {
      "viewsmax": {
        "url": "https://api.viewsmax.com/api/mcp",
        "headers": { "Authorization": "Bearer vmx_YOUR_KEY" }
      }
    }
  }
  ```

## 3. Run a quick test

> Which of my social accounts can you reach through ViewsMax?

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

> Turn the README's feature list into a LinkedIn post and a shorter X version, and keep both as ViewsMax drafts.

What happens next:

- Before it uses a ViewsMax tool that changes something, Cursor asks for your OK.
- ViewsMax stores the post as a draft, or queues it for the time you gave.
- At publish time ViewsMax sends it 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

- **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.
- **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.
- **Tidy the queue:** What's going out this weekend? Push anything on X back by two hours.

## Fixes

- **The server appears but has no tools.** Check the key sits right after "Bearer " with no stray spaces and hasn't been rotated, then restart Cursor.
- **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.