What is Transistor Mcp

Transistor-MCP is an MCP server implementation designed to interact with the Transistor.fm API, enabling users to manage podcasts, episodes, and access analytics.

Use cases

Use cases for Transistor-MCP include managing podcast episodes, uploading audio content for new episodes, retrieving analytics data for shows, and integrating podcast management into larger applications.

How to use

To use Transistor-MCP, add it to your MCP settings configuration file with your Transistor API key. You can then utilize various tools such as getting user details, uploading audio files, and listing shows and episodes.

Key features

Key features of Transistor-MCP include user authentication, pre-signed URLs for audio uploads, listing shows and episodes, and pagination support for managing large sets of data.

Where to use

Transistor-MCP is suitable for podcast management, analytics tracking, and audio file handling in various applications, especially those focused on content creation and distribution.

Transistor MCP Server

This MCP server provides tools to interact with the Transistor.fm API, allowing you to manage podcasts, episodes, and view analytics.

Configuration

Add the server to your MCP settings configuration file with your Transistor API key:

{
  "mcpServers": {
    "transistor": {
      "command": "node",
      "args": [
        "path/to/Transistor-MCP/build/index.js"
      ],
      "env": {
        "TRANSISTOR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

get_authenticated_user

Get details of the authenticated user account.

authorize_upload

Get a pre-signed URL for uploading an audio file. Use this before creating an episode with a local audio file.

Response includes:

• upload_url: Pre-signed S3 URL for uploading the file
• content_type: Content type to use when uploading (e.g., “audio/mpeg”)
• expires_in: Time in seconds until the upload URL expires
• audio_url: Final URL to use when creating the episode

list_shows

List all shows in your Transistor.fm account, ordered by updated date (newest first). Returns a paginated list with 10 items per page.

Note: All parameters are optional. Calling this endpoint without parameters will return the first page of shows.

list_episodes

List episodes for a specific show.

get_episode

Get detailed information about a specific episode.

get_analytics

Get analytics for a show or specific episode. Defaults to the last 14 days if no dates are provided.

create_episode

Create a new episode.

update_episode

Update an existing episode.

get_all_episode_analytics

Get analytics for all episodes of a show. Defaults to the last 7 days if no dates are provided.

list_webhooks

List all webhooks for a show.

subscribe_webhook

Subscribe to a webhook for a show.

unsubscribe_webhook

Unsubscribe from a webhook.

Important Notes

• API requests are rate-limited to 10 requests per 10 seconds (as prescribed by the (https://developers.transistor.fm/#:~:text=API requests are rate-limited,to use the API again.)[Transistor API reference])
• Dates must be in “dd-mm-yyyy” format
• Page numbers start at 0
• All endpoints support:
  • Sparse fieldsets: Specify which fields to return using fields[resource_type][]
  • Including related resources: Use include[] to fetch related resources in a single request
• Include arrays use the format ["resource_name"]
• Fields objects specify which fields to return for each resource type
• All tools return data in JSONAPI format with proper relationships and metadata

Example Usage

List shows:

// List first page of shows (default behavior)
const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "list_shows",
  arguments: {}
});

// List shows with pagination and filtering
const resultWithParams = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "list_shows",
  arguments: {
    page: 1,
    per: 20,
    private: true,
    query: "podcast"
  }
});

Get episode details:

const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_episode",
  arguments: {
    episode_id: "123456",
    include: ["show"],
    fields: {
      episode: ["title", "summary", "description"],
      show: ["title"]
    }
  }
});

Get show analytics:

// Get analytics for the last 14 days (default behavior)
const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_analytics",
  arguments: {
    show_id: "123456"
  }
});

// Get analytics for a specific date range
const resultWithDates = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_analytics",
  arguments: {
    show_id: "123456",
    start_date: "01-01-2024",
    end_date: "31-01-2024"
  }
});

// Get analytics for a specific episode
const episodeAnalytics = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_analytics",
  arguments: {
    show_id: "123456",
    episode_id: "789012",
    start_date: "01-01-2024",
    end_date: "31-01-2024"
  }
});

Update episode:

const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "update_episode",
  arguments: {
    episode_id: "123456",
    title: "Updated Episode Title",
    summary: "New episode summary",
    description: "New detailed description",
    season_number: 2,
    episode_number: 5
  }
});

Get all episode analytics:

// Get analytics for all episodes for the last 7 days (default behavior)
const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_all_episode_analytics",
  arguments: {
    show_id: "123456"
  }
});

// Get analytics for all episodes for a specific date range
const resultWithDates = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_all_episode_analytics",
  arguments: {
    show_id: "123456",
    start_date: "01-01-2024",
    end_date: "31-01-2024"
  }
});

Manage webhooks:

// List webhooks
const webhooks = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "list_webhooks",
  arguments: {
    show_id: "123456"
  }
});

// Subscribe to webhook
const subscription = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "subscribe_webhook",
  arguments: {
    event_name: "episode_created",
    show_id: "123456",
    url: "https://your-webhook-endpoint.com/hook"
  }
});

// Unsubscribe from webhook
const unsubscribe = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "unsubscribe_webhook",
  arguments: {
    webhook_id: "webhook123"
  }
});

Get authenticated user:

const result = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "get_authenticated_user",
  arguments: {}
});

Authorize audio file upload:

// First, get a pre-signed upload URL
const auth = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "authorize_upload",
  arguments: {
    filename: "my-episode.mp3"
  }
});

// Then use the returned upload_url to upload your file via PUT request
// Finally, use the returned audio_url when creating your episode:
const episode = await use_mcp_tool({
  server_name: "transistor",
  tool_name: "create_episode",
  arguments: {
    show_id: "123456",
    title: "My New Episode",
    audio_url: auth.data.attributes.audio_url
  }
});

Not Yet Implemented

The following Transistor API features are not yet implemented:

• Private Episodes functionality (subscribers management)
  • GET /v1/subscribers
  • GET /v1/subscribers/:id
  • POST /v1/subscribers
  • POST /v1/subscribers/batch
  • PATCH /v1/subscribers/:id
  • DELETE /v1/subscribers
  • DELETE /v1/subscribers/:id