# ViewsMax MCP server

Connect Claude, ChatGPT, Cursor or any MCP client to ViewsMax to post, schedule and track on YouTube, TikTok, Instagram, X, LinkedIn, Threads and Bluesky.

- MCP endpoint: https://api.viewsmax.com/api/mcp (Streamable HTTP; no SSE, no stdio)
- Capability discovery (JSON): https://api.viewsmax.com/api/ai
- OAuth metadata: https://api.viewsmax.com/.well-known/oauth-authorization-server · dynamic client registration: POST https://api.viewsmax.com/oauth/register
- Human version of this page: https://viewsmax.com/mcp · install hub: https://viewsmax.com/ai.md

## What an AI agent can do

- List linked accounts and brands (read: list_connected_accounts, list_brands)
- Publish or schedule to any mix of 7 platforms — draft, scheduled or posted, with per-platform caption and option overrides (write: create_post, update_post)
- Host an image or video by URL for TikTok, Instagram and YouTube posts (write: upload_media)
- Read each platform's publish result for a post (read: get_post, list_posts)
- Create offers and a tracked link per placement (write: create_offer, create_tracking_link)
- Read clicks, conversions and revenue — totals and a daily series (read: get_offer_stats, get_stats_timeseries)
- Browse outlier videos by platform, score, views and date (read: list_outliers, get_outlier)
- Search YouTube for a new topic, or pull in a specific video by URL (write: search_outliers, fetch_outlier)
- Generate and read an AI breakdown of why a video over-performed (write: generate_outlier_breakdown, get_outlier_breakdown)
- Save outliers to a tagged library (write: save_outlier, list_saved_outliers, remove_saved_outlier)
- Follow a creator's channel and pull in their recent videos (write: add_outlier_channel, get_outlier_channel_ingest)
- File a feature request (write: create_feature_request)

Not through the MCP:

- Generating images or video — you supply media by URL and ViewsMax hosts it
- Clipping or editing video
- Reading or replying to comments and DMs
- Channel analytics such as follower counts or watch time — the MCP reports offer clicks, conversions and revenue
- Plans and billing — those stay in the ViewsMax web app

## How to connect

### Claude

Custom connector (Customize → Connectors) — OAuth. Guide: https://viewsmax.com/claude (plain text: https://viewsmax.com/claude.md)

```
https://api.viewsmax.com/api/mcp
```

### Claude Code

claude mcp add --transport http — OAuth or API key. Guide: https://viewsmax.com/claude-code (plain text: https://viewsmax.com/claude-code.md)

```
claude mcp add --transport http --scope user viewsmax https://api.viewsmax.com/api/mcp
```

### Claude Cowork

Shares the claude.ai connector — OAuth. Guide: https://viewsmax.com/claude-cowork (plain text: https://viewsmax.com/claude-cowork.md)

```
https://api.viewsmax.com/api/mcp
```

### ChatGPT

Developer mode → custom connector — OAuth. Guide: https://viewsmax.com/chatgpt (plain text: https://viewsmax.com/chatgpt.md)

```
https://api.viewsmax.com/api/mcp
```

### Codex

codex mcp add, or ~/.codex/config.toml — OAuth or API key. Guide: https://viewsmax.com/codex (plain text: https://viewsmax.com/codex.md)

```
codex mcp add viewsmax --url https://api.viewsmax.com/api/mcp
```

### Cursor

~/.cursor/mcp.json — API key. Guide: https://viewsmax.com/cursor (plain text: https://viewsmax.com/cursor.md)

```
{
  "mcpServers": {
    "viewsmax": {
      "url": "https://api.viewsmax.com/api/mcp",
      "headers": { "Authorization": "Bearer vmx_YOUR_KEY" }
    }
  }
}
```

### OpenClaw

ViewsMax skill (drives the REST API) — API key. Guide: https://viewsmax.com/openclaw (plain text: https://viewsmax.com/openclaw.md)

```
mkdir -p viewsmax && curl -o viewsmax/SKILL.md https://viewsmax.com/skills/viewsmax/SKILL.md
openclaw skills install ./viewsmax --global
```

### Hermes Agent

~/.hermes/config.yaml — OAuth or API key. Guide: https://viewsmax.com/hermes (plain text: https://viewsmax.com/hermes.md)

```
mcp_servers:
  viewsmax:
    url: "https://api.viewsmax.com/api/mcp"
    auth: oauth
```

## Authentication & security

- **OAuth 2.1 + PKCE** (Chat apps and IDEs: Claude, ChatGPT, Codex, Hermes). Point the client at https://api.viewsmax.com/api/mcp. It finds ViewsMax through https://api.viewsmax.com/.well-known/oauth-authorization-server, registers itself (dynamic client registration at https://api.viewsmax.com/oauth/register), and opens a browser where you sign in and choose read-only or full access. Access tokens are scoped to this endpoint and last an hour; refresh tokens last 30 days.
- **API key** (Headless agents, scripts, CI, Cursor). Generate a key under Settings → AI Assistant Access (it starts with vmx_), read-only or full. Send it as Authorization: Bearer vmx_… on every request — keys in the URL are rejected. Rotate the key to revoke access instantly; the same key works on the REST API.
- Scopes: mcp:read / mcp:write. Read-only credentials hide write tools from tools/list.
- Every tools/call is recorded in the user's audit log (Settings → AI Assistant Access).

Rate limits:

- All MCP requests: 120 per minute, per credential
- create_post: 180 per hour
- upload_media: 40 per hour · 100 MB per file
- fetch_outlier: 60 per hour
- search_outliers: 30 per hour
- generate_outlier_breakdown: 30 per hour
- add_outlier_channel: 10 per hour

## Tools (30)

### Accounts & brands (4)

See which channels are linked, group them into brands, and hand the user a connect link when one is missing.

- `list_connected_accounts`
- `list_brands`
- `get_connect_url`
- `disconnect_account`

### Posting & scheduling (6)

Host media by URL, then draft, schedule or publish to any mix of platforms and read each platform's result.

- `upload_media`
- `create_post`
- `list_posts`
- `get_post`
- `update_post`
- `delete_post`

### Offers & link tracking (8)

Create offers with goals, mint a tracked link per placement, and read clicks, conversions and revenue over time.

- `list_offers`
- `create_offer`
- `get_offer`
- `update_offer`
- `delete_offer`
- `create_tracking_link`
- `get_offer_stats`
- `get_stats_timeseries`

### Outlier research (11)

Find videos that beat their channel's average, get an AI breakdown of why, save the best, and follow creators.

- `list_outliers`
- `search_outliers`
- `get_outlier`
- `fetch_outlier`
- `get_outlier_breakdown`
- `generate_outlier_breakdown`
- `list_saved_outliers`
- `save_outlier`
- `remove_saved_outlier`
- `add_outlier_channel`
- `get_outlier_channel_ingest`

### Feedback (1)

File a feature request on the user's behalf.

- `create_feature_request`

No MCP resources or prompts — tools only.

## Platforms

- 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

- **Schedule a cross-post:** Post the video at https://example.com/clip.mp4 to TikTok and YouTube tomorrow at 9am. Caption: "Three mistakes new creators make."
- **Find the best earner:** Which of my offers made the most money in the last 30 days, and which platform sent the clicks?
- **Research what's working:** Find YouTube outliers about home workouts from this month, explain why the top one worked, and save it to my library.

## FAQ

**What is the ViewsMax MCP server?**

A remote MCP (Model Context Protocol) server at https://api.viewsmax.com/api/mcp that gives any MCP client 30 tools for posting and scheduling to YouTube, TikTok, Instagram, X, LinkedIn, Threads and Bluesky, tracking offers and revenue, and researching outlier videos. It runs over Streamable HTTP, so there is nothing to install or host.

**Which AI agents work with it?**

Any client that speaks MCP over Streamable HTTP. ViewsMax has step-by-step guides for Claude, Claude Code, Claude Cowork, ChatGPT, Codex, Cursor and Hermes Agent, plus a REST-based skill for OpenClaw.

**How do I connect Claude to ViewsMax?**

In Claude, open Customize → Connectors, add a custom connector with the address https://api.viewsmax.com/api/mcp, then press Connect and approve read-only or full access. The same connector carries over to Claude Code and Claude Cowork.

**How do I connect ChatGPT to ViewsMax?**

Turn on Developer mode under Settings → Security and login, then add a custom connector at chatgpt.com/plugins with the address https://api.viewsmax.com/api/mcp and complete the sign-in. ViewsMax is an action connector — post, schedule, read stats — not a deep-research source.

**Does the MCP server support SSE or stdio?**

No. The server speaks Streamable HTTP only — the current MCP transport that Claude, ChatGPT, Codex, Cursor and Hermes all support. There is no SSE endpoint and nothing to run locally.

**How does authentication work?**

Two ways, both sent as a Bearer token. Chat apps use OAuth 2.1 with PKCE: the client registers itself, you sign in to ViewsMax in a browser and choose read-only or full access. Headless agents use an API key (vmx_…) generated under Settings → AI Assistant Access. Keys go in the Authorization header, never the URL.

**Can I give an agent read-only access?**

Yes. Pick Read-only on the OAuth consent screen or generate a read-only API key. Read-only credentials carry the mcp:read scope, so write tools such as create_post don't even appear in the agent's tool list.

**Can I see what my AI agent did?**

Yes. Every tool call — the tool, its arguments and whether it failed — is recorded in your audit log under Settings → AI Assistant Access. Rotating the API key or disconnecting the OAuth client revokes access instantly.

**Which platforms can an AI agent post to?**

YouTube, TikTok, Instagram, X, LinkedIn, Threads and Bluesky — whichever of them you have linked in ViewsMax. Platform logins stay inside ViewsMax; the agent only ever holds a ViewsMax permission.

**Can it generate videos or images?**

No. The MCP server publishes media you already have: give the agent a public URL and upload_media hosts the file (JPEG, PNG, WebP, GIF, MP4 or MOV, up to 100 MB) for the post.

**Can it post to several accounts at once?**

Yes. One create_post call can target any mix of platforms, or a brand — a named group of accounts — with per-platform caption and option overrides. Each platform is published separately and keeps its own status, so one failure never blocks the rest.

**What are the rate limits?**

120 MCP requests a minute per credential. Per hour: 180 create_post, 40 upload_media, 60 fetch_outlier, 30 search_outliers, 30 generate_outlier_breakdown and 10 add_outlier_channel. A limited call returns a retry-after hint rather than failing silently.

**Does the MCP server cost extra?**

No. Connecting an agent is included on every plan, including the free one. What the agent can do follows your ViewsMax plan limits, such as monthly posts and active offers.

**Does it expose MCP resources or prompts?**

No — tools only. All 30 capabilities are tools, and the server's own instructions tell the agent the typical posting and research flows. A JSON description of everything lives at https://api.viewsmax.com/api/ai.