Subscribr Logo
Log in

Use Subscribr with AI Clients (MCP)

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

Connect your paid 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 all paid Subscribr teams.

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 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 AI Integrations in Subscribr

  1. Sign in to Subscribr
  2. Open your account menu and select AI 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 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 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:

  • 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). The npm package also bundles a portable Agent Plugins manifest for plugin-capable clients. 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. Use the CLI for deterministic API work; use MCP for conversational Projects, workspace, and Intel workflows. 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 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 requires an Automation plan or higher and is managed on the Developer page.

Next Steps

Previous
Language Support
Next
Generate Videos with Subscribr Video