# Castmagic MCP MCP

> Castmagic automates content repurposing. Feed it any audio or video URL and get a complete media asset package back automatically. This MCP generates high-accuracy transcripts, polished show notes, social media posts, titles, and more—all from one call to your agent.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** audio-transcription, content-repurposing, show-notes, ai-content-generation, media-processing, social-media-content

## Description

You shoot a long video or record a podcast. That content is valuable, but it's also hard to reuse. You shouldn't have to sit there watching the footage just to pull out key quotes or write summaries. This MCP takes full control of that workflow. Connect this service through Vinkius and give your agent the ability to process media directly. It instantly turns hours of video into structured, ready-to-post assets. Need a transcript? Send an audio URL and get speaker identification alongside perfect text. Want marketing copy? Run the transcript through the content generation tools; it spits out show notes, titles, and social posts. You manage your entire library—listing all recordings or deleting old transcripts—all from chat. It’s about making media usable without any manual work.

## Tools

### create_new_transcript
This tool sends a new audio or video URL to start the transcription process.

### delete_transcript
Use this tool to remove an old transcript and all its associated data from your account.

### get_castmagic_account
Retrieves core usage metrics, including your current quota and subscription information.

### get_magic_content
Generates AI content like show notes or social posts for a specific transcript ID you provide.

### get_transcript_details
Retrieves the full text and metadata for an already processed, specific transcript.

### list_castmagic_recordings
Shows a list of all audio or video files you have uploaded to your Castmagic account.

### list_transcript_speakers
Lists every identified speaker within a transcript, helping you manage and track metadata for those voices.

### list_transcripts
Provides a list of all transcripts currently saved in your workspace.

## Prompt Examples

**Prompt:** 
```
Transcribe this audio file: https://example.com/episode1.mp3
```

**Response:** 
```
Submitting 'episode1.mp3' for transcription... I've started the job (ID: tr_12345). I'll let you know when it's finished processing.
```

**Prompt:** 
```
Get the magic content for transcript ID tr_12345.
```

**Response:** 
```
Retrieving AI assets for tr_12345... I found show notes, 3 LinkedIn posts, and 5 suggested titles. Which one should I display first?
```

**Prompt:** 
```
Show me my last 10 recordings in Castmagic.
```

**Response:** 
```
Retrieving your recent recordings... I found 10 entries including 'Weekly Sync' and 'Product Launch Interview'. All are successfully processed.
```

## Capabilities

### Generate full text transcripts
Submit a video or audio URL, and the MCP returns a high-accuracy transcript that identifies who spoke what.

### Create marketing assets
The system generates polished show notes, suggested titles, and multiple social media posts based on an existing transcript.

### Audit content library
List all previously uploaded recordings and transcripts so you can manage your entire content history in one place.

### Analyze speakers
Identify every person who spoke in a recording, allowing you to track speaker metadata for more accurate records.

### Monitor usage limits
Retrieve your current account status and subscription details so you always know how much content processing capacity you have left.

## Use Cases

### The podcaster needs evergreen content
A podcaster finishes an hour-long interview. Instead of spending three hours manually summarizing it for Instagram, they submit the URL and use `get_magic_content`. The agent returns five tailored social posts, a blog draft, and full show notes in minutes.

### The agency needs to clean up data
An agency project manager has completed multiple client recordings. They need to audit everything before billing. They use `list_transcripts` first, then run `list_castmagic_recordings` to ensure no source media was missed.

### The marketer needs accurate reporting
A marketing team records a panel discussion with five experts. They need to know who said what for follow-up actions. They process the video, then use `list_transcript_speakers` to get a detailed list of every participant.

### The creator needs cleanup
A content creator keeps old drafts and test transcripts cluttering their workspace. Instead of manually deleting them in the UI, they simply send a prompt asking the agent to run `delete_transcript` for specific IDs.

## Benefits

- Saves time on content drafting. Instead of manually writing show notes, use the `get_magic_content` tool to generate polished marketing summaries directly from a transcript ID.
- Keeps your workflow clean and organized. Use `list_castmagic_recordings` to see every piece of media you've processed, giving you a centralized content audit trail.
- Ensures compliance by tracking usage. The `get_castmagic_account` tool lets you monitor your quota so you never get stuck mid-project due to overages.
- Builds reliable data structures. By running the transcript through the speaker analysis tools, you don't just get text; you get metadata identifying who said what.
- Maximizes output from minimal input. You only need one URL and a few agent prompts to generate transcripts, show notes, and social posts—all in one flow.

## How It Works

The bottom line is: your agent handles the entire content pipeline—from raw media input to final, ready-to-use text output.

1. First, subscribe to the MCP and input your Castmagic Secret Key into your agent.
2. Next, send a command with the URL of the video or audio file you want processed.
3. Finally, wait for the job confirmation; once complete, ask the agent to generate specific assets, like show notes or social posts.

## Frequently Asked Questions

**How do I start the process using create_new_transcript?**
You send this MCP a direct URL to an audio or video file, and it starts transcribing. The agent will give you a job ID and let you know when the transcript is ready for use.

**Can I get show notes without writing them manually using get_magic_content?**
Yes. Once `create_new_transcript` finishes, running `get_magic_content` provides AI-driven assets like show notes and social posts based on the transcript's text.

**What if I need to track who said what in the recording? Should I use list_transcript_speakers?**
Yes, use `list_transcript_speakers`. This tool doesn't just give you a name; it lets you manage and refine metadata for every identified voice in your recorded material.

**Do I need to manually delete old transcripts after using delete_transcript?**
No. Calling `delete_transcript` removes both the transcript and all associated data, cleaning up your workspace completely with one command.

**How can I check my usage limits and quota using get_castmagic_account?**
You use `get_castmagic_account` to pull your current subscription status and remaining credits. This lets you monitor your usage directly, so you never hit an unexpected paywall mid-project.

**If I need to see a list of all my past media transcriptions, should I use the list_transcripts tool?**
Yes, running `list_transcripts` pulls every available audio and video transcription record. This gives you an immediate index of your entire content history within the system.

**What does running list_castmagic_recordings actually show me?**
It provides a comprehensive list of every original recording you've uploaded to Castmagic. Use this tool to quickly audit and manage all your source content material.

**How do I pull out the specific text data from a finished recording using get_transcript_details?**
Just provide the transcript ID to `get_transcript_details`. You immediately retrieve the full, accurate text content and all associated metadata for that specific file.

**Can I generate social media posts from a podcast link?**
Yes! Use the `create_new_transcript` tool with your podcast audio URL, then use `get_magic_content` once processing is finished to retrieve AI-generated social posts.

**How do I check if my transcription is ready?**
Use the `list_transcripts` tool. Your agent will return a list of all jobs and their current status (e.g., Processing, Finished).

**Which languages does Castmagic support?**
Castmagic supports over 18 languages including English, Spanish, French, German, and Portuguese. You can specify the language when creating a new transcript.