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 & CLI (Claude Code / Codex / Cursor / OpenClaw)

If you use an AI coding agent like Claude Code, Codex, Cursor, or OpenClaw, 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.

Install with one command from your project root:

npx @giltotherescue/subscribr-cli

This installs the skill into both .agents/skills/ (Codex, Cursor, OpenClaw) and .claude/skills/ (Claude Code). It also works with any other agent that follows the Agent Skills spec. To also install the zero-dependency Python CLI alongside it:

npx @giltotherescue/subscribr-cli --with-cli

The CLI wraps every Subscribr API endpoint and is useful for automation, scripting, and AI agent tool use. View the repo on GitHub.

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

• Open /ai-integrations in Subscribr to connect your AI client
• Install the AI Agent Skill for Claude Code or Codex
• Learn about Intel research
• Explore Video Ideas
• Check out the API documentation for full programmatic access