Subscribr Logo
Log in

Use Subscribr with AI Clients (MCP)

Connect your Subscribr account to Claude, ChatGPT, OpenClaw, Cursor, VS Code, and other AI assistants using the Model Context Protocol.

Connect your Subscribr account to Claude, ChatGPT, OpenClaw, Cursor, VS Code, and other AI assistants using MCP. Access your Projects board, Tasks, notifications, channels, scripts, ideas, templates, Voice Profiles, and Intel research directly from the conversation.

What This Does

Subscribr supports the Model Context Protocol (MCP), which lets AI clients securely connect to external tools and data.

Once connected, your AI client can:

  • Read data from your Subscribr workspace
  • Look up YouTube channels and videos from Intel
  • Open rich MCP Apps for Intel results, script previews, and the interactive Projects board
  • Create, update, move, promote, comment on, archive, and restore Projects when your role allows it
  • Manage custom templates and validate a strict Voice Profile before explicitly committing it

Example prompts:

  • "Show me my latest scripts"
  • "Search Intel for outlier videos about home workouts"
  • "Look up @mkbhd and summarize the channel"
  • "Show my Projects board and what needs my attention"

MCP access is available to every Subscribr team, including the free plan.

Where To Start

Open Integrations from the main app navigation, then find Chat assistants. That section gives you:

  • Your MCP server address, ready to copy
  • A direct link to the Subscribr listing in the Claude directory
  • A link back to this article for the per-client steps below

Working with a coding agent instead of a chat assistant? See Connect an AI Agent — that path is faster and needs no manual setup.

Compatible Clients

Client Type Setup Style
Claude Desktop Guided OAuth setup
Claude.ai Guided OAuth setup
ChatGPT Developer mode connector with guided OAuth
Cursor / VS Code Advanced remote HTTP MCP setup
OpenClaw Advanced MCP bridge or remote server setup
Other MCP clients Use the same server URL; exact steps vary by client

Standard Setup

Step 1: Open Integrations in Subscribr

  1. Sign in to Subscribr
  2. Open your account menu and select Integrations
  3. Copy your MCP server URL

The production server URL is:

https://subscribr.ai/mcp/subscribr

Step 2: Add Subscribr to Your AI Client

In your AI client, add a new MCP server or integration and use:

  • Server URL: https://subscribr.ai/mcp/subscribr
  • Transport: HTTP or Streamable HTTP if the client asks
  • Auth: OAuth, if the client supports it

Step 3: Complete OAuth

Most end-user clients will redirect you to Subscribr automatically.

  1. Sign in to Subscribr in the browser window
  2. Approve the MCP connection
  3. Return to your AI client
  4. Start a new chat and use Subscribr tools

Client Notes

Claude Desktop

  • Add a new integration/server
  • Paste the Subscribr MCP URL
  • Complete the browser authorization flow

Claude.ai

  • Open Integrations
  • Add the Subscribr MCP URL
  • Complete OAuth in the browser

ChatGPT

  • Open Settings → Apps & Connectors → Advanced settings
  • Enable Developer mode, create a connector, and use the same MCP URL
  • Complete OAuth in the browser

We're preparing Subscribr for the ChatGPT app directory and Claude Connectors Directory. Until those listings are approved, connect directly with the server URL above.

Cursor / VS Code

These are more developer-oriented MCP clients.

  • Add a new remote HTTP MCP server
  • Use the Subscribr MCP URL above
  • Choose HTTP or Streamable HTTP if asked
  • If the client supports OAuth, use it
  • If the client only supports manual bearer headers, use a personal access token instead

OpenClaw

OpenClaw setups vary more than Claude or ChatGPT.

  • Add Subscribr through your OpenClaw MCP bridge, plugin, or remote server settings
  • Use the same MCP URL
  • Prefer OAuth if your OpenClaw setup supports it
  • If it only supports manual bearer auth, use a personal access token instead

Personal Access Tokens (Advanced)

Most customers do not need a token for Claude, Claude.ai, or ChatGPT.

Tokens are only for advanced clients or local workflows that do not support OAuth well.

Important constraints:

  • Tokens are managed under Your own code on the Integrations page
  • Only team admins can manage tokens
  • Creating a token requires team owner or admin access

If your client needs manual bearer auth, use:

Authorization: Bearer YOUR_TOKEN_HERE

Available Tools

Subscribr exposes a focused 23-tool semantic catalog at /mcp/subscribr. App-producing read tools are separated by result shape so Claude and ChatGPT can select the correct interactive UI during tool discovery.

Projects and Work

Tool What It Does
list_projects List/filter Projects and launch the interactive board
get_project Fetch one canonical idea- or Script-backed Project
get_script_project Fetch a Script-backed Project and launch its interactive preview
create_project Create an idea or Script Project with idempotency
update_project Edit, move, preview/archive, or restore a Project
promote_idea Preview or promote an idea into a linked Script without generation
add_project_comment Add a Project comment and bounded mentions
list_my_work List assigned work and Project notifications
mark_project_notifications_read Mark one, many, or all Project notifications read

Research, Operations, and Workspace

Tool What It Does
search_youtube_channels Search YouTube channels through Intel
search_youtube_videos Search YouTube videos through Intel
get_youtube_channel Look up one YouTube channel and show its detail app
get_youtube_video Look up one YouTube video and show its detail app
generate_ideas Preview and dispatch asynchronous idea generation
get_operation Poll a durable operation returned by Subscribr
get_channel_workspace Read bounded Channel, competitor, template, and voice context
list_research_videos Browse tracked-channel videos in the interactive video app
get_research_video Fetch one tracked video and show its detail app
list_research_bookmarks Browse saved Channel and video bookmarks
save_bookmark Save an Intel channel or video bookmark with idempotency
save_template Create, update, preview/archive, or restore a custom template
validate_voice_profile Validate/canonicalize a complete Voice Profile and issue a receipt
commit_voice_profile Explicitly commit the exact receipt-bound Voice Profile

Destructive or costly actions use preview-then-confirm receipts. Retried writes use idempotency keys and revision-bearing writes use the latest expected revision.

Example Workflows

Research and Ideation

  1. Ask: "Search Intel for outlier videos about meal prep"
  2. Ask: "Look up the top channel from those results"
  3. Ask: "Generate 5 ideas for my channel inspired by that pattern"
  4. Ask: "Bookmark that channel for later"

Script Review

  1. Ask: "Show me my recent scripts"
  2. Ask: "Open the first script"
  3. Review the script with your AI assistant and ask for feedback or rewrites

Competitive Research

  1. Ask: "Look up the YouTube channel @competitorhandle"
  2. Ask: "Search Intel for videos similar to this niche"
  3. Ask: "Summarize what makes the top outliers stand out"

Troubleshooting

"I don't see the Projects tools"

Confirm the connection uses https://subscribr.ai/mcp/subscribr.

If Subscribr was already connected before the latest tools shipped, refresh its tool list or reconnect it, then begin a new conversation.

"I can't add bookmarks or generate ideas"

Write actions require editor access or higher on your team.

"The client says authentication is required"

That is normal for OAuth-capable clients. Complete the browser sign-in and authorization flow.

"My client only supports manual bearer headers"

Use a personal access token, but only if:

  • you are a team owner or admin
  • a team admin can create the token for you

"Connection failed"

Check:

  1. The server URL is exactly https://subscribr.ai/mcp/subscribr
  2. You are signed in to the team you expect
  3. Your client is using remote HTTP MCP, not local stdio mode

Security & Privacy

  • All MCP data is scoped to your authenticated Subscribr account
  • You can only access your own team data
  • Session-cookie auth is not allowed for MCP requests
  • OAuth is preferred because your AI client never receives your password
  • Tokens can be revoked anytime on the Integrations page

Coding Agents

If you use a coding agent like Claude Code, Codex, Cursor, or OpenClaw, do not set it up by hand. Paste one line and it sets itself up:

Fetch https://subscribr.ai/agent-setup/prompt.md and follow it to set up Subscribr.

Copy that from the Agents section of the Integrations page. It installs the Subscribr CLI and API skill, which give the agent the complete REST API rather than the curated MCP tool set.

Full instructions, plan requirements, and troubleshooting: Connect an AI Agent.

Coding agents get the REST API and chat assistants get MCP. Both work on every plan, including free. Use whichever suits the client — or both.

MCP vs REST API

The MCP server is designed for research, ideation, and Project/workflow management inside AI chat clients. The canonical endpoint provides supported Project, Task/notification, custom-template, and strict Voice Profile workflows with text-only fallback and an embedded Projects board.

For content creation — creating scripts, generating outlines, exporting content, managing competitors, or setting up webhooks — use the REST API. The REST API works on every plan, and its access tokens live under Your own code on the Integrations page.

Next Steps

Previous
Language Support
Next
Generate Videos with Subscribr Video