# Hiro.fm MCP

> Hiro.fm MCP connects your audio distribution workflow directly into your AI client. Manage private podcast shows, list all subscribers, and automate access control for premium content feeds—all without touching a web dashboard.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** podcasting, audio-content, creator-economy, access-control, subscription-management, digital-distribution

## Description

This MCP lets you treat your entire private podcast operation like a chat conversation with your AI agent. You can instantly manage who gets to listen to what, publishing new episodes and organizing contacts just by asking the right questions. If you're building an automated membership system or running paid courses, this is it. Instead of juggling complex dashboards for uploads and user permissions, you talk to your agent. It handles creating new listeners, assigning them to specific shows, and even tagging them based on their activity. You’ll manage all these functions through a single connection via Vinkius. The result? Your AI acts like a full-time podcast producer and account manager, keeping your private content feeds running smoothly.

## Tools

### add_audio
Adds a new episode file directly to one of your private shows.

### create_contact
Creates a brand new listener profile in your system.

### get_contact
Retrieves specific details for an existing contact or listener.

### get_show
Gets detailed metadata about a single, specific podcast show.

### grant_access
Grants listening access to a specified user for a particular show.

### list_audio
Lists all available episodes within a specific podcast show.

### list_contacts
Retrieves a full list of every listener currently in your account.

### list_shows
Lists all the private podcasts and shows you have set up.

### list_tags
Gets a list of all available tags used to organize your listeners.

### revoke_access
Removes listening access from a user for a specific show, immediately taking away their privileges.

## Prompt Examples

**Prompt:** 
```
List all my podcast shows from Hiro.fm.
```

**Response:** 
```
I've retrieved your private shows. You currently have 3 active podcasts: 'Elite Coaching' (ID: sh_1), 'Daily Briefs' (ID: sh_2), and 'Masterclass' (ID: sh_3). Which one would you like to manage?
```

**Prompt:** 
```
Grant listener access for 'john@example.com' to the 'Elite Coaching' show.
```

**Response:** 
```
Access granted! John (ID: con_99) can now listen to 'Elite Coaching'. They will receive an automated email with instructions on how to access their private feed immediately.
```

**Prompt:** 
```
Add a new episode titled 'Welcome Session' to my show ID 'sh_1'.
```

**Response:** 
```
Episode 'Welcome Session' has been successfully added to your show. Your listeners will be able to stream it through their private feed immediately.
```

## Capabilities

### Manage Listener Profiles
Create new contact records or pull up existing listener details using their ID or email.

### Control Show Access
Programmatically give or take listening access to specific shows for any user in your database.

### Publish New Episodes
Add new audio files and episodes to existing private podcast shows using titles and direct media URLs.

### View Show Status
List all your active private podcasts and retrieve metadata like subscriber counts for each show.

### Organize Audiences
Manage contact tags to group listeners, which lets you send targeted content or run automated workflows.

## Use Cases

### Onboarding New Paid Members
A user signs up for the 'Masterclass' feed. The agent automatically runs `create_contact` to make sure John Doe is in the system, then executes `grant_access` to give him immediate listening rights for that specific show.

### Archiving Expired Content
A user's subscription expires. The agent first runs `get_contact` to verify their status and then calls `revoke_access` on the relevant shows, locking them out until they renew.

### Bulk Campaign Setup
The marketing team needs to announce a new series. They use `list_shows` to get all IDs, then run `add_audio` for the new episode across multiple shows in one go.

## Benefits

- Stop manual access control. You can use `grant_access` or `revoke_access` to instantly manage who hears what, perfect for paid content gating.
- Keep your content pipeline moving. Use `add_audio` with titles and media URLs to publish new episodes without leaving your coding environment.
- Build better reports by listing all shows using `list_shows`, giving you the necessary IDs and metadata to track engagement metrics.
- Targeted communication is easier when you use `list_tags`. You can group users so your agent knows exactly who needs a specific announcement.
- Manage the entire user base with simple calls. Use `create_contact` or `get_contact` to handle new sign-ups and retrieve necessary listener details on demand.

## How It Works

The bottom line is you get to control your entire audio platform using natural language prompts instead of clicking through complicated admin panels.

1. First, subscribe to the MCP and plug in your Hiro.fm API key from your Creator Settings.
2. Next, tell your AI client what you need—for example, 'List all my podcast shows' or 'Grant access for John Doe.'
3. Your agent executes the commands through the MCP and returns structured data, like a list of show IDs or a confirmation that access was granted.

## Frequently Asked Questions

**How do I get my Hiro.fm API Key?**
Log in to your Hiro.fm creator account, navigate to **Creator Settings** > **Integrations**, and copy your Bearer Token.

**Can I grant access to multiple shows?**
Yes, you can use the `grant_access` tool multiple times for different `show_id` values to give a contact access to several podcasts.

**Does it support adding audio from URLs?**
Yes, the `add_audio` tool requires a direct media URL to the audio file you want to add as a new episode.

**When I use the list_contacts tool, what details about listeners can I retrieve?**
You get a comprehensive record of every listener in your system. This includes basic profile information and contact identifiers for management. You can then pass these IDs to other tools like grant_access or get_contact.

**How does the list_tags tool help me manage my audience segments?**
The list_tags tool displays every tag you have applied to your contacts. This lets you group listeners by criteria, allowing you to send highly targeted content or promotional material.

**What information is included when I use the list_shows command?**
The list_shows tool returns key metadata for every private podcast. You receive the show's unique ID and current subscriber count. This helps you quickly gauge your content performance.

**What happens immediately after I use the revoke_access tool?**
The user loses all streaming access to that specific show right away. This is useful for instantly managing paid memberships or removing contacts whose access has expired.

**If I run list_audio, what kind of technical data can I get about episodes?**
It provides a structured list detailing every available episode for a show. Each entry includes the title, duration, and the direct media URL you need to distribute the content.