yabby logo

MCP server

Connect Claude and other AI assistants to yabby via the Model Context Protocol — create websites, add channels, and curate videos in plain language.

yabby ships a built-in MCP (Model Context Protocol) server. Connect it to Claude, Cursor, or any other MCP-capable assistant and you can manage your websites conversationally: "Create a site for my channel, add the channel, hide all Shorts older than a year, and feature my three best videos."

The MCP server exposes the same capabilities as the REST API.

Connect

The server speaks the modern Streamable HTTP transport at:

https://www.yabby.page/api/mcp

Clients that support MCP's OAuth sign-in — Claude, Claude Desktop, Claude Code, Cursor and most others — only need the URL. When you connect, yabby asks you to sign in and to choose the workspace the assistant may access.

Claude (web & desktop): Settings → Connectors → Add custom connector, paste the URL, then click Connect.

Claude Code:

claude mcp add --transport http yabby https://www.yabby.page/api/mcp

Then run /mcp in Claude Code and choose Authenticate.

API key

For scripts, CI, or clients without OAuth support, authenticate with an API key from Workspace Settings → API, passed as a Bearer token. The key determines the workspace.

Claude Code:

claude mcp add --transport http yabby https://www.yabby.page/api/mcp \
  --header "Authorization: Bearer yabby_your_api_key"

Claude Desktop / other clients (config JSON):

{
  "mcpServers": {
    "yabby": {
      "type": "http",
      "url": "https://www.yabby.page/api/mcp",
      "headers": {
        "Authorization": "Bearer yabby_your_api_key"
      }
    }
  }
}

Cursor (.cursor/mcp.json) uses the same url + headers shape.

Available tools

ToolWhat it does
get_account_infoWorkspace, plan, and plan limits
list_websites / get_websiteRead websites and their settings
create_website / update_websiteCreate and configure websites
publish_website / unpublish_websiteGo live / back to draft
delete_websitePermanently delete a website
search_youtube_channelsFind a channel's YouTube id by name
list_channels / get_channelRead channels incl. sync status
add_channel / remove_channel / sync_channelManage channels
list_videos / get_videoBrowse and search videos
update_videoHide/unhide or feature a video
get_video_transcriptionFetch a video's transcript (for summaries, show notes, posts)
list_playlists / get_playlistBrowse playlists incl. their videos
update_playlistHide/unhide or feature a playlist
list_promo_blocks / create_promo_block / update_promo_block / delete_promo_blockManage promo (CTA/sponsor) blocks
assign_promo_block / unassign_promo_blockAssign blocks to videos (all, playlist, list, or published-after)
get_promo_block_statsAnonymous click stats per block
list_pages / create_page / update_page / delete_pageManage static content pages (Tiptap JSON)
get_newsletter_integration / get_newsletter_statsRead newsletter setup (never returns credentials) and signup counts
connect_newsletter / update_newsletter_settings / disconnect_newsletterManage the newsletter provider integration

What to try

  • "Set up a website for the channel «my channel name» and publish it." — the assistant searches the channel, creates the site, adds the channel, waits for the sync, and publishes.
  • "Which of my videos have the most views? Feature the top 3."
  • "Get the transcript of my latest video and draft a newsletter from it."
  • "Hide every video with «livestream» in the title."

Security notes

  • A connected assistant can do everything in its workspace that you can — including deleting websites. Destructive tools are marked as such, so assistants ask you to confirm before running them.
  • An OAuth connection only reaches the workspace you picked when connecting. Disconnect it anytime under Workspace Settings → API → Connected apps (owners and admins can disconnect any member's apps) — it stops working immediately, as it does when you leave the workspace.
  • Rate limits apply per API key (120 requests/minute), shared with the REST API.
  • Revoke an API key in the dashboard to cut off access instantly.

On this page