什么是 Transistor？
通过 Transistor.fm API 管理播客与单集内容，支持查询、更新和运营相关流程。
README
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.
{
// No parameters needed
}
authorize_upload
Get a pre-signed URL for uploading an audio file. Use this before creating an episode with a local audio file.
{
"filename": string // Required: Name of the audio file to upload
}
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.
{
"page": number, // Optional, defaults to 0 (first page)
"per": number, // Optional, defaults to 10 items per page
"private": boolean, // Optional: filter for private shows
"query": string // Optional: search query
}
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.
{
"show_id": string, // Required
"page": number, // Optional, defaults to 0
"per": number, // Optional, defaults to 10
"query": string, // Optional: search query
"status": string, // Optional: "published", "draft", or "scheduled"
"order": string // Optional: "desc" (newest first) or "asc" (oldest first), defaults to "desc"
}
get_episode
Get detailed information about a specific episode.
{
"episode_id": string, // Required
"include": string[], // Optional: array of related resources to include
"fields": { // Optional: sparse fieldsets
"episode": string[], // Fields to include for episode
"show": string[] // Fields to include for show
}
}
get_analytics
Get analytics for a show or specific episode. Defaults to the last 14 days if no dates are provided.
{
"show_id": string, // Required
"episode_id": string, // Optional: include for episode-specific analytics
"start_date": string, // Optional: format "dd-mm-yyyy", required if end_date is provided
"end_date": string // Optional: format "dd-mm-yyyy", required if start_date is provided
}
create_episode
Create a new episode.
{
"show_id": string, // Required
"title": string, // Required
"audio_url": string, // Required
"summary": string, // Optional
"description": string, // Optional: may contain HTML
"transcript_text": string, // Optional: full episode transcript
"author": string, // Optional
"explicit": boolean, // Optional
"image_url": string, // Optional: episode artwork
"keywords": string, // Optional: comma-separated list
"number": number, // Optional: episode number
"season_number": number, // Optional
"type": string, // Optional: "full", "trailer", or "bonus"
"alternate_url": string, // Optional: override share_url
"video_url": string, // Optional: YouTube URL
"email_notifications": boolean, // Optional: override show setting
"increment_number": boolean // Optional: auto-set next episode number
}
update_episode
Update an existing episode.
{
"episode_id": string, // Required
"title": string, // Optional
"summary": string, // Optional
"description": string, // Optional: may contain HTML
"transcript_text": string, // Optional: full episode transcript
"author": string, // Optional
"explicit": boolean, // Optional
"image_url": string, // Optional: episode artwork
"keywords": string, // Optional: comma-separated list
"number": number, // Optional: episode number
"season_number": number, // Optional
"type": string, // Optional: "full", "trailer", or "bonus"
"alternate_url": string, // Optional: override share_url
"video_url": string, // Optional: YouTube URL
"email_notifications": boolean // Optional: override show setting
}
get_all_episode_analytics
Get analytics for all episodes of a show. Defaults to the last 7 days if no dates are provided.
{
"show_id": string, // Required
"start_date": string, // Optional: format "dd-mm-yyyy", required if end_date is provided
"end_date": string // Optional: format "dd-mm-yyyy", required if start_date is provided
}
list_webhooks
List all webhooks for a show.
{
"show_id": string // Required
}
subscribe_webhook
Subscribe to a webhook for a show.
{
"event_name": string, // Required: e.g., "episode_created"
"show_id": string, // Required
"url": string // Required: URL to receive webhook events
}
unsubscribe_webhook
Unsubscribe from a webhook.
{
"webhook_id": string // Required
}
get_show
Get a show by ID.
show_id: string // Required
update_show
Update a show.
show_id: string // Required
author: string // Optional
category: string // Optional
copyright: string // Optional
description: string // Optional
explicit: boolean // Optional
image_url: string // Optional
keywords: string // Optional
language: string // Optional
owner_email: string // Optional
secondary_category: string // Optional
show_type: "episodic" | "serial" // Optional
title: string // Optional
time_zone: string // Optional
website: string // Optional
publish_episode
Publish or schedule an episode without otherwise editing its metadata.
episode_id: string // Required
status: "published" | "scheduled" | "draft" // Required
published_at: string // Optional
get_download_summary
Get a computed download summary for a show or episode. Returns total downloads, daily average, week-over-week trend, and best/worst day.
show_id: string // Required
episode_id: string // Optional
start_date: string // Optional
end_date: string // Optional
compare_episodes
Compare download performance across multiple episodes, sorted by total downloads.
episode_ids: string[] // Required - array of episode IDs
start_date: string // Optional
end_date: string // Optional
list_subscribers
List subscribers for a show.
show_id: string // Required
page: number // Optional
per: number // Optional
query: string // Optional
get_subscriber
Get a subscriber by ID.
subscriber_id: string // Required
create_subscriber
Create a subscriber.
show_id: string // Required
email: string // Required
skip_welcome_email: boolean // Optional
create_subscribers_batch
Create multiple subscribers in a single request.
show_id: string // Required
emails: string[] // Required
skip_welcome_email: boolean // Optional
update_subscriber
Update a subscriber's email.
subscriber_id: string // Required
email: string // Required
delete_subscriber
Delete a subscriber. Provide either subscriber_id, OR both show_id and email.
subscriber_id: string // Optional - either this, or both show_id + email
show_id: string // Optional - required with email when no subscriber_id
email: string // Optional - required with show_id when no subscriber_id
Important Notes
- API requests are rate-limited to 10 requests per 10 seconds (as prescribed by the (https://developers.transistor.fm/#:~:text=API%20requests%20are%20rate%2Dlimited,to%20use%20the%20API%20again.)[Transistor API reference])
- Dates accept ISO
yyyy-mm-dd(recommended) and are converted to the Transistor API'sdd-mm-yyyyautomatically;dd-mm-yyyyis also accepted - 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
- Sparse fieldsets: Specify which fields to return using
- 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
}
});
Coverage
This server now covers the full documented Transistor API surface, including shows,
episodes, analytics, download summaries, webhooks, and private-podcast subscriber
management (GET/POST/PATCH/DELETE /v1/subscribers).
常见问题
Transistor 是什么？
通过 Transistor.fm API 管理播客与单集内容，支持查询、更新和运营相关流程。
相关 Skills
MCP构建
by anthropics
聚焦高质量 MCP Server 开发，覆盖协议研究、工具设计、错误处理与传输选型，适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。
✎ 想让 LLM 稳定调用外部 API，就用 MCP构建：从 Python 到 Node 都有成熟指引，帮你更快做出高质量 MCP 服务器。
Slack动图
by anthropics
面向Slack的动图制作Skill，内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程，适合把创意或上传图片快速做成可直接发送的Slack动画。
✎ 帮你快速做出适配 Slack 的动图，内置约束规则和校验工具，少踩上传与播放坑，做表情包和演示都更省心。
接口测试套件
by alirezarezvani
扫描 Next.js、Express、FastAPI、Django REST 的 API 路由，自动生成覆盖鉴权、参数校验、错误码、分页、上传与限流场景的 Vitest 或 Pytest 测试套件。
✎ 帮你把API与集成测试自动化跑顺，减少回归漏测；能力全面，尤其适合复杂接口场景的QA团队。
相关 MCP Server
Slack 消息
编辑精选by Anthropic
Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。
✎ 这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点，特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过，它目前只是参考实现，文档有限，不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。
by netdata
io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。
✎ 这个工具解决了运维人员需要手动检查系统状态的痛点，最适合 DevOps 团队让 Claude 自动分析性能数据。不过，它依赖 NetData 的现有部署，如果你没用过这个监控平台，得先花时间配置。
by d4vinci
Scrapling MCP Server 是专为现代网页设计的智能爬虫工具，支持绕过 Cloudflare 等反爬机制。
✎ 这个工具解决了爬取动态网页和反爬网站时的头疼问题，特别适合需要批量采集电商价格或新闻数据的开发者。不过，它依赖外部浏览器引擎，资源消耗较大，不适合轻量级任务。