How to Use the Listen Notes MCP in Windsurf

Q: Can Windsurf handle genre-based filtering with Listen Notes?

Yes, Windsurf queries listpodcastgenres to understand the available categories. It then feeds the correct genre ID into getbestpodcasts to narrow down your search. You do not have to look up the ID mapping yourself.

Let Windsurf and its Cascade agent hunt down, organize, and pull podcast metadata directly into your workspace without manual steps.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Listen Notes MCP to Windsurf

Create your Vinkius account to connect Listen Notes to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Listen Notes with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Podcast Discovery with Windsurf

`get_best_podcasts` gets top-rated shows based on specific genres you pass to it. Cascade runs this tool, identifies the genre IDs, and automatically matches them against your project configuration. Look, here's the thing: you don't have to copy-paste genre lists or lookup codes manually. The agent chains this with other commands to build local JSON feeds of top shows instantly.

Deep-Dive Search and Episode Analysis

`search_podcasts_or_episodes` queries the entire Listen Notes database using a raw text query. When you ask Cascade to find shows about a specific topic, it triggers this tool to fetch matching episodes. Cascade reads the returned search payloads and extracts the exact episode IDs. It then passes those IDs directly to subsequent tools to pull transcripts or show notes.

Pull Show Outlines into the IDE

`get_podcast_details` extracts the complete metadata and episode list for any specific podcast ID. Cascade parses this massive payload to map out season structures or episode release schedules. This integration eliminates manual API testing cycles inside your IDE. Your agent uses the data to generate markdown summaries or populate local database schemas on the fly.

Setup guide

Set up Listen Notes MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Listen Notes MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Listen Notes payment history." If connected, Cascade will call the Listen Notes tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "listen-notes-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Listen Notes. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Listen Notes now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Listen Notes MCP in Windsurf

You type your query directly into the Cascade chat interface. Windsurf then runs `search_podcasts_or_episodes` to get matches and formats them inline. It is fast and does not require manual API key configuration.

Yes, Windsurf queries `list_podcast_genres` to understand the available categories. It then feeds the correct genre ID into `get_best_podcasts` to narrow down your search. You do not have to look up the ID mapping yourself.

The server passes API rate limit headers directly to your Windsurf session. Cascade reads these limits to regulate how fast it fires off subsequent tool calls. This keeps your development key from getting temporarily blocked.

Yes, you can ask Cascade to fetch metadata for any single episode. It runs `get_episode_details` to pull the audio URL, publish date, and descriptions directly into your open file. It is a great way to build quick mockups.

Your Listen Notes keys and podcast queries remain entirely inside the secure Vinkius sandbox during execution. They are never logged or stored on any external servers. The connection is ephemeral and closes immediately after Cascade completes the task.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript