Fireside.fm (unofficial)
Unofficial MCP server for the Fireside.fm podcast API: stats, episodes and uploads
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- today
Similar MCP servers
About Fireside.fm (unofficial)
Fireside.fm (unofficial) is an open-source MCP server for news and media. It runs locally on your machine and is started by your AI client.
This community-built server connects Claude and other MCP hosts to a Fireside.fm podcast account. A Read Only API key enables the reporting tools, while a Read/Write key also lets the assistant create drafts, edit show notes, upload audio, cover art and transcripts, and publish, schedule or unpublish episodes. It is not affiliated with or endorsed by Fireside.
Several safeguards are built in. Uploads are off until you name allowed directories in FIRESIDE_UPLOAD_DIRS, MP3 files are inspected and flagged if they differ from the dashboard's suggested settings, and FIRESIDE_READ_ONLY forces read tools only. Limits come from Fireside itself: episodes cannot be deleted, chapters cannot be uploaded, and requests are capped at 120 per minute per key.
It runs over stdio from npm and needs Node.js 22 or later.
Install
Run in a terminal
claude mcp add firesidefm-mcp-server --env FIRESIDE_API_TOKEN='<FIRESIDE_API_TOKEN>' -- npx -y firesidefm-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"firesidefm-mcp-server": {
"command": "npx",
"args": [
"-y",
"firesidefm-mcp-server"
],
"env": {
"FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"firesidefm-mcp-server": {
"command": "npx",
"args": [
"-y",
"firesidefm-mcp-server"
],
"env": {
"FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"firesidefm-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"firesidefm-mcp-server"
],
"env": {
"FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"firesidefm-mcp-server": {
"command": "npx",
"args": [
"-y",
"firesidefm-mcp-server"
],
"env": {
"FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"firesidefm-mcp-server": {
"command": "npx",
"args": [
"-y",
"firesidefm-mcp-server"
],
"env": {
"FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
FIRESIDE_API_TOKENFireside API key, created at https://app.fireside.fm/api_tokens. A Read Only key offers only the read tools.RequiredFIRESIDE_PODCASTToken or slug of the podcast to use when a request does not name one.FIRESIDE_READ_ONLYSet to true to offer only the read tools, even with a Read/Write key.FIRESIDE_UPLOAD_DIRSDirectories whose files may be uploaded as episode audio, cover art or transcripts, or podcast cover art, separated as in PATH. Uploads are off when unset.
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- fireside_get_account
- Shows the connected account and key type.
- fireside_list_podcasts
- Lists podcasts you own or collaborate on.
- fireside_get_podcast
- Returns one podcast's details and all-time downloads.
- fireside_list_episodes
- Lists episodes newest first, filterable by status.
- fireside_get_episode
- Returns every field of one episode.
- fireside_get_episode_metrics
- Returns downloads per episode at several time windows.
- fireside_get_monthly_downloads
- Returns downloads per calendar month.
- fireside_get_daily_downloads
- Returns downloads per day for a podcast or episode.
- fireside_create_episode
- Creates a private draft episode.
- fireside_update_episode
- Changes episode fields, audio, cover art or transcript.
- fireside_upload_file
- Uploads an MP3, cover image or transcript from allowed folders.
- fireside_publish_episode
- Publishes, schedules or backdates an episode.
- fireside_unpublish_episode
- Returns an episode to a private draft.
What it does
- Download statistics
- Per-episode metrics, monthly totals and daily downloads for up to a year per call.
- Episode management
- Create, edit, publish, schedule and unpublish episodes.
- File uploads
- Upload MP3 audio, cover images and plain-text transcripts from approved folders.
- Read-only mode
- A Read Only key or FIRESIDE_READ_ONLY limits the server to read tools.
- Audio checks
- MP3 headers are inspected before upload and mismatches are flagged.
- Multi-podcast support
- Podcasts and episodes can be named by token or slug.
Good for
- Ask how last month's episode downloads compare
- Draft a new episode with show notes from your assistant
- Schedule an episode for release
- Attach a transcript or new cover art to an episode
Pricing
Open source
MIT licence; requires a Fireside account and API key
Fireside.fm (unofficial) FAQ
What do I need to run it?
Node.js 22 or later and a Fireside API key from app.fireside.fm/api_tokens.
Can it delete episodes?
No. The Fireside API does not allow deleting episodes or changing podcast settings.
Is it safe to use with a Read/Write key?
The README advises a Read Only key unless you want the assistant to change or publish episodes.
What is the license?
MIT.
Is Fireside.fm (unofficial) free?
Yes. Fireside.fm (unofficial) is open source, so you can use and self-host it for free.
How do I add Fireside.fm (unofficial) to Claude Code?
Run this command in your terminal: claude mcp add firesidefm-mcp-server --env FIRESIDE_API_TOKEN='<FIRESIDE_API_TOKEN>' -- npx -y firesidefm-mcp-server
What are the best alternatives to Fireside.fm (unofficial)?
The closest alternatives to Fireside.fm (unofficial) are TrendRadar, Design Feeds, Crypto Feeds, Finance Feeds and Fyyd.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

