AI-driven coding is evolving rapidly, and the integration of the Model Context Protocol (MCP) inside the Windsurf IDE represents a major leap forward. For developers who rely on educational YouTube videos, coding tutorials, and tech conference recordings, having to toggle back and forth between browser tabs and the editor is a constant friction point.

By hooking up the youtube-transcripts-mcp server directly to Windsurf, you can program, analyze video guides, and query technical tutorials directly from your active coding workspace.

In this guide, we will walk you through the exact setup process, configure the JSON files, and explore practical programming workflows with MCP.

What is Model Context Protocol (MCP)?

Model Context Protocol (MCP) is an open standard designed by Anthropic that allows AI models (like Claude inside Windsurf) to securely access local or remote tools, APIs, and file structures. Instead of relying on static context windows, the AI agent can dynamically call tools to retrieve real-time data as it works on your code.

For developers, this means the Windsurf AI agent can:

Read local files and execute workspace terminal commands.
Call external APIs to fetch real-time specifications.
Pull down video transcript data directly into the chat prompt to draft, debug, or document code.

Setting Up Windsurf and MCP

Windsurf supports custom MCP server integrations natively. To get started, you will configure your user settings to declare the transcript tool.

Step 1: Open the Config File

Open your Windsurf custom tools configuration file. Depending on your Operating System, this is located at:

macOS: ~/Library/Application Support/Windsurf/User/profiles/default/config.json
Windows: %APPDATA%\Windsurf\User\profiles\default\config.json
Linux: ~/.config/Windsurf/User/profiles/default/config.json

Alternatively, you can open Windsurf, go to Settings (Cmd+, or Ctrl+,), search for "MCP", and click Edit in config.json.

Step 2: Add the YouTube Transcripts Server

Add the following JSON configuration to the mcpServers object inside the configuration file:

{
  "mcpServers": {
    "youtube-transcripts": {
      "command": "npx",
      "args": [
        "-y",
        "@transcribeyt/mcp-server"
      ],
      "env": {}
    }
  }
}

Save the file and restart Windsurf. The IDE will automatically pull down the package, initialize the server, and register the tools:

get_transcript: Fetches the clean transcript of any public YouTube video.
get_transcript_with_timestamps: Fetches the transcript along with precise timestamps.

4 Practical Developer Workflows in Windsurf

Now that the server is configured, let's explore how to leverage it during your coding sessions.

1. Translating Video Tutorials to Code

If you are learning a new framework or library (e.g., configuring a complex Tailwind component or setting up a Next.js middleware) from a video tutorial, you can ask Windsurf's AI agent:

"Check the code setup described in this tutorial: https://www.youtube.com/watch?v=dQw4w9WgXcQ. Recreate the configuration file for my current directory."

Windsurf will fetch the transcript, parse the spoken code instructions, and write the file directly.

2. Debugging API Integrations

When an API changes and the only updated documentation is a 10-minute walkthrough video by the developer advocate, you don't need to sit through the video. Feed the link to Windsurf:

"Retrieve the transcript for this video https://www.youtube.com/watch?v=example to see how they handle the new webhook payload. Update our routing file to match."

3. Assembling Study Notes

If you are studying algorithms or software architecture, you can transcribe lecture playlists and ask the agent to summarize concepts:

"Read the transcript for this system design video https://www.youtube.com/watch?v=example. Generate a Markdown cheatsheet comparing horizontal scaling and vertical partitioning."

4. Writing Inline Documentation

You can easily document codebase features by referencing their release videos:

"Look up the transcript for our product demo at https://www.youtube.com/watch?v=example and write a README section outlining the user workflow."

Conclusion

Integrating MCP servers inside Windsurf turns your IDE into a unified workspace. By eliminating context switching, you can write better code faster while directly learning from the world's largest video knowledge base.

Programming in Windsurf with Model Context Protocol (MCP) and YouTube Transcripts