Skip to content
MCP server

Fireside.fm (unofficial)

Unofficial MCP server for the Fireside.fm podcast API: stats, episodes and uploads

Runs locallyStatus and history
Install
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-server

Add 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.Required
  • FIRESIDE_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.

How AIPoweredBot checks servers