How to Use the Castmagic MCP in Cursor

Q: How do I use Castmagic data to test my code in Cursor?

Ask the Cursor agent to run gettranscriptdetails for a specific file. It uses the MCP Server to fetch the real JSON payload so you can write and test your parsing scripts.

Q: Can Cursor upload new audio files to Castmagic?

Yes. Your Cursor agent can trigger createnewtranscript with an audio URL to start a new job directly from the editor sidebar.

Q: How do I inspect speaker lists in Cursor using Castmagic?

Run the listtranscriptspeakers tool. Cursor will display the identified speakers, which you can use to map names to your local database.

Q: Can I check my API quota limits with this MCP Server?

Yes, tell your agent to run getcastmagicaccount to see your current subscription tier and remaining upload minutes.

Code and build media workflows directly in Cursor by pulling Castmagic transcript data into your active workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Castmagic MCP to Cursor

Create your Vinkius account to connect Castmagic to Cursor 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 Castmagic with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Feed real transcript data directly into your Cursor code

Stop writing code against fake JSON payloads. When building custom media pipelines, your Cursor agent can run `get_transcript_details` to pull actual speaker text and metadata straight into your active editor. This lets you write parser scripts or frontend layouts using real-world data shapes. You can test your code against actual outputs from `list_transcripts` without leaving your IDE.

Generate marketing assets inside Cursor with this MCP Server

If you are building automated publishing tools, use `get_magic_content` to fetch pre-built social posts and summaries directly. The server returns structured text that your Cursor agent can format or save straight to your project files. You can instantly generate markdown files or draft newsletter templates using your actual media assets. It makes building content distribution apps incredibly fast.

Audit your media assets and speaker maps in Cursor

Use `list_transcript_speakers` to inspect the exact speaker IDs returned from your audio files. This is perfect for debugging custom audio players or transcript editors where speaker mapping needs to be precise. You can also run `list_castmagic_recordings` to verify that your uploaded media files match your database records. It keeps your local development environment perfectly in sync with your cloud assets.

Setup guide

Set up Castmagic MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Castmagic MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Castmagic transactions." If the MCP tools are loaded correctly, Cursor will call the Castmagic tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "castmagic-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 Castmagic. 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 Castmagic 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 Castmagic MCP in Cursor

Ask the Cursor agent to run `get_transcript_details` for a specific file. It uses the MCP Server to fetch the real JSON payload so you can write and test your parsing scripts.

Yes. Your Cursor agent can trigger `create_new_transcript` with an audio URL to start a new job directly from the editor sidebar.

Run the `list_transcript_speakers` tool. Cursor will display the identified speakers, which you can use to map names to your local database.

Yes, tell your agent to run `get_castmagic_account` to see your current subscription tier and remaining upload minutes.

Yes. All transcript text and audio metadata pass through an encrypted MCP sandbox. Your raw data is never cached or used for training, keeping your intellectual property isolated.

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