# Podcast Episode Counter MCP. AI Agent Connect

> Podcast Episode Counter MCP lets your AI client process podcast datasets to find specific episode counts. You can pull totals for entire datasets, filter by specific shows, or check how many episodes are released versus upcoming. It turns raw podcast data into clear, actionable numbers without you having to manually count rows.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_iLdJNqZBZJmTIdNnNHbQ9WkRVgLYigMhwA9FBiQ5/ai-agent-connect
- **Tags:** podcast, analytics, data, episodes, counting

## Description

If you are working with large podcast datasets, you know how tedious it is to manually tally episode counts or filter through release statuses. This MCP gives your AI agent the ability to perform those calculations instantly. Instead of you scrolling through spreadsheets or JSON files, you just ask your client for the numbers. You can find the total number of unique episodes in a dataset using list_all_episodes. If you need to focus on a specific show, count_episodes_by_series handles that. You can also check the status of your content with count_episodes_by_status to see what is already out and what is still in the pipeline. For a broader view, get_episode_summary_stats provides a high level look at how your episodes are distributed. It is a direct way to turn messy podcast data into organized stats through your preferred AI interface.

## Tools

### count_episodes_by_status
This tool counts episodes based on their release state, such as released or upcoming.

### get_episode_summary_stats
This tool provides a high level overview of how episodes are distributed across the entire dataset.

### list_all_episodes
This tool returns the total number of unique episodes found in your dataset.

### count_episodes_by_series
Use this to find exactly how many episodes belong to a specific podcast series.

## Prompt Examples

**Prompt:** 
```
How many total episodes are in this list?
```

**Response:** 
```
There are 42 unique episodes in the provided dataset.
```

**Prompt:** 
```
How many episodes belong to the 'Daily News' series?
```

**Response:** 
```
The 'Daily News' series has 12 episodes.
```

**Prompt:** 
```
Give me a summary of the episode distribution.
```

**Response:** 
```
The dataset contains 50 episodes total, distributed across 5 series, with 40 released and 10 upcoming.
```

## Capabilities

### Dataset Totals
Your agent calculates the exact number of unique episodes in a file.

### Series Filtering
The AI isolates counts for specific shows within a larger dataset.

### Status Tracking
Your agent compares released content against upcoming episodes.

### Distribution Analysis
The tool provides a summary of how episodes are spread across different categories.

## Use Cases

### Content Auditing
Check how many episodes a specific series has produced to date.

### Release Planning
Compare the number of released episodes against upcoming ones to manage workload.

### Dataset Summarization
Get a high level overview of an entire podcast catalog's distribution.

### Series Comparison
Compare episode counts between different shows in the same dataset.

## Benefits

- Eliminates manual counting of rows in large datasets.
- Provides instant status updates on released and upcoming content.
- Allows for quick filtering of specific shows within a massive list.
- Turns raw data into summary statistics through natural language.

## How It Works

You connect the MCP to your AI client and then ask questions about your podcast data.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Provide your podcast dataset to your AI agent.
3. Ask a question about episode counts or series totals.
4. The agent uses the specific tool to calculate the answer.
5. Receive the exact count or summary immediately.

## Frequently Asked Questions

**What AI clients can I use with this MCP?**
You can use any MCP compatible client, including Claude, Cursor, Windsurf, and VS Code.

**Do I need to host the MCP myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after connection.

**Can I filter episodes by their release status?**
Yes, the count_episodes_by_status tool allows you to see how many episodes are released or upcoming.

**How does this handle multiple different shows?**
The count_episodes_by_series tool lets you isolate and count episodes for a specific series within your data.

**Is there a way to get a broad overview of my data?**
Yes, you can use the get_episode_summary_stats tool to get a high level distribution of all episodes.

**How does the tool handle duplicate episodes?**
The tools use unique identifiers to ensure each episode is only counted once, even if it appears multiple times in the input list.

**What kind of data does the summary tool provide?**
The `get_episode_summary_stats` tool provides the total unique count, a distribution of episodes by series, and a distribution by status.
