Subscribr Logo
Log in

Use Subscribr with AI Clients

Connect your paid Subscribr account to Claude, ChatGPT, OpenClaw, Cursor, VS Code, and other AI assistants using MCP. Access your channels, scripts, ideas, Intel research, and bookmarks 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 app cards for Intel results and script previews
  • Run write actions like bookmarking or idea generation if your team role allows it

Example prompts:

  • "Show me my latest scripts"
  • "Search Intel for outlier videos about home workouts"
  • "Look up @mkbhd and summarize the channel"
  • "Add this channel to my bookmarks"

MCP access is available to paid Subscribr teams. Intel tools require an Intel-enabled plan, which on normal subscriptions is currently Creator and above.

Where To Start

Open AI Integrations from the main app navigation. That page gives you:

  • Your MCP server URL
  • Client-specific setup guidance
  • OAuth-first connection instructions
  • Advanced notes for manual token-based clients

Compatible Clients

Client Type Setup Style
Claude Desktop Guided OAuth setup
Claude.ai Guided OAuth setup
ChatGPT Guided OAuth setup when remote MCP/connectors are available
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 AI Integrations in Subscribr

  1. Sign in to Subscribr
  2. Open AI Integrations from the main navigation
  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

  • Add Subscribr through the remote MCP/connectors flow when your ChatGPT account supports it
  • Use the same MCP URL
  • Complete OAuth in the browser

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 on the Developer page
  • Only team admins can manage tokens
  • The Developer page requires an API-enabled plan

If your client needs manual bearer auth, use:

Authorization: Bearer YOUR_TOKEN_HERE

Available Tools

Subscribr exposes 15 customer tools.

Your Account Data

Tool What It Does
my_team Team info, plan status, credits, and user info
my_channels List your Subscribr channels
get_my_channel Get details for a specific channel
my_scripts List your scripts
get_my_script Get full script content by ID
my_videos Browse videos from your tracked channels
get_my_video Get full video details and optional transcript
get_my_channel_ideas View video ideas for a channel
my_bookmarks List saved bookmarks

YouTube Research (Intel)

Tool What It Does Plan Required
intel_search_channels Search Subscribr's Intel channel database Creator or higher
intel_search_videos Search Intel for outlier videos and patterns Creator or higher
get_youtube_channel Look up a YouTube channel by handle, ID, or URL Creator or higher
get_youtube_video Look up a YouTube video by ID or URL Creator or higher

Actions

Tool What It Does Permission Required
generate_ideas Generate new video ideas for a Subscribr channel Editor or higher
add_bookmark Save a YouTube channel or video to bookmarks Editor or higher

Viewers can use read-only tools. Write actions require editor access or higher.

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 all 15 tools"

Intel tools require Creator, Automation, or Scale. Call my_team to check your current plan details.

"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:

  • your team has an API-enabled plan
  • a team admin can create the token for you

"Connection failed"

Check:

  1. The server URL is exactly https://subscribr.ai/mcp/subscribr
  2. Your team is on a paid plan
  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 Developer page

AI Agent Skill (Claude Code / Codex)

If you use an AI coding agent like Claude Code or Codex, you can install a skill file that teaches the agent how to use the Subscribr REST API. The skill covers authentication, endpoints, common workflows, and links to the full API reference.

Run this from your project root:

mkdir -p .claude/skills/subscribr-api && curl -sL https://subscribr.ai/skills/subscribr-api/SKILL.md -o .claude/skills/subscribr-api/SKILL.md

The skill is focused on the REST API (Automation plan and above), which covers the full platform including content creation, script generation, exports, and webhooks. It also documents MCP tools for research and ideation.

You can find this on the Developer page in the app under the Overview tab.

The AI Agent Skill is for coding agents that call APIs on your behalf. For conversational AI clients like Claude Desktop or ChatGPT, use the MCP setup described above instead.

MCP vs REST API

The MCP server is designed for research, ideation, and reviewing content inside AI chat clients. It provides read access to your account data and Intel search, plus lightweight write actions like bookmarking and idea generation.

For content creation — creating scripts, generating outlines, exporting content, managing competitors, or setting up webhooks — use the REST API. The REST API requires an Automation plan or higher and is managed on the Developer page.

Next Steps

Previous
Language Support
Next
Understanding Credits