# Fireside.fm (unofficial)

> Fireside.fm (unofficial) is an open-source MCP server for news and media. Unofficial MCP server for the Fireside.fm podcast API: stats, episodes and uploads. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/jkotzker/firesidefm-mcp-server
- **MCP Registry name:** io.github.jkotzker/firesidefm-mcp-server
- **Categories:** [news and media](https://ai-powered.com/categories/news-and-media)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add firesidefm-mcp-server --env FIRESIDE_API_TOKEN='<FIRESIDE_API_TOKEN>' -- npx -y firesidefm-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "firesidefm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "firesidefm-mcp-server"
      ],
      "env": {
        "FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "firesidefm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "firesidefm-mcp-server"
      ],
      "env": {
        "FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "firesidefm-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "firesidefm-mcp-server"
      ],
      "env": {
        "FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "firesidefm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "firesidefm-mcp-server"
      ],
      "env": {
        "FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "firesidefm-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "firesidefm-mcp-server"
      ],
      "env": {
        "FIRESIDE_API_TOKEN": "<FIRESIDE_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Finance Feeds](https://ai-powered.com/mcp/finance-feeds): Finance Feeds is a freemium MCP server for finance and payments.
- [Fyyd](https://ai-powered.com/mcp/fyyd): Fyyd is a freemium MCP server for news and media.
- [Science Feeds](https://ai-powered.com/mcp/science-feeds): Science Feeds is a freemium MCP server for news and media.
- [Health Feeds](https://ai-powered.com/mcp/health-feeds): Health Feeds is a freemium MCP server for health and science.
- [Gaming Feeds](https://ai-powered.com/mcp/gaming-feeds): Gaming Feeds is a freemium MCP server for news and media.

---
Source: https://ai-powered.com/mcp/fireside-fm-unofficial
