Log inSubmit server
Op3 MCP logo

Op3 MCP

by conorbronsdon

Read-only MCP tools for OP3 podcast downloads, episode performance, listener geography, and app share.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Op3 MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "conorbronsdon-op3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@conorbronsdon/op3-mcp"
      ],
      "env": {
        "OP3_API_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

conorbronsdon/op3-mcp MCP server exposes OP3 podcast analytics to AI assistants through read-only MCP tools. It resolves a show from a UUID, podcast GUID, or encoded feed URL, then retrieves downloads, episode comparisons, app share, country estimates, or raw download events. Most queries require the show UUID returned by the lookup tool. Reach for it when OP3 already tracks the podcast and an agent needs analytics that may not be available from a hosting API.

Use cases

  • Identify a podcast from its feed URL or GUID
  • Compare recent episode download performance
  • Inspect monthly and weekly show downloads
  • Estimate listener country and app shares
  • Filter raw download events by date or episode

Key features

  • Show lookup by UUID, podcast GUID, or feed URL
  • Monthly and weekly download summaries
  • Per-episode 1/3/7/30-day and all-time counts
  • Top apps and player share
  • Sampled country and region aggregation
  • Raw download timeseries with device fields

Tools6

What Op3 MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 59d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · @conorbronsdon/op3-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads148Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Tools exposed6Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Op3 MCP works

What conorbronsdon/op3-mcp MCP server does

The conorbronsdon/op3-mcp MCP server connects AI assistants to OP3, the Open Podcast Prefix Project. It exposes read-only podcast analytics through six tools, covering show identification, download trends, episode-level performance, listening applications, listener countries, and raw download events.

OP3 records downloads when an episode URL uses its redirect prefix. The server can therefore report only activity that passed through OP3; downloads from before the prefix was added are not backfilled. The server does not modify shows, episodes, feeds, or analytics data.

Tools and capabilities

  • op3_get_show accepts a show UUID, podcast GUID, or base64-encoded feed URL. It returns the show UUID, title, podcast GUID, and stats page URL. With include_episodes, it also returns episode IDs, titles, and publication dates.
  • op3_show_downloads returns monthly totals, a weekly breakdown, and average weekly downloads.
  • op3_episode_downloads reports each recent episode's downloads during its first 1, 3, 7, and 30 days, plus its all-time count. Use limit to restrict the result size.
  • op3_top_apps lists downloading apps and players with counts and percentage shares for the previous three calendar months.
  • op3_top_countries estimates country or regional shares by aggregating raw download records on the client side.
  • op3_downloads_timeseries returns individual records containing time, country, app, and device data for a selected date range.

How it works

Start with op3_get_show when the show UUID is unknown. The returned UUID is required by most other tools. List-producing tools use a low default limit to keep responses smaller. For raw records, keep limits modest because each record is verbose and OP3 rate limits are not publicly documented.

Country results are samples rather than exact lifetime totals. Because OP3 provides raw records oldest-first and no native geography aggregate, op3_top_countries defaults to a 90-day window when no start date is supplied. max_records controls the sample size, with a documented cap of 20,000; the response indicates when the sample reached its cap.

Setup and configuration

The conorbronsdon/op3-mcp MCP server requires an OP3 API token in the OP3_API_TOKEN environment variable. Obtain a token from OP3 after signing in. OP3 also publishes the shared preview token preview07ce for testing against public shows.

For Claude Code or Claude Desktop, configure the server with the npx command and package @conorbronsdon/op3-mcp, passing OP3_API_TOKEN in the server environment. The project targets Node 18 or newer. A local development setup can clone the repository, run npm install, build with npm run build, and start with OP3_API_TOKEN=your-token npm start.

Limitations and notes

The app-share window is fixed to the last three calendar months by OP3. There is no aggregate device tool, although device fields appear in timeseries records. OP3 download queries exclude bots by default.

A missing or invalid token produces an authentication error. Other typed failures distinguish rate limits, missing shows or resources, invalid parameters, OP3 server failures, and network or unmapped errors. Tool failures retain the MCP isError: true response shape.

If a feed does not use the OP3 prefix, the server has no OP3 data to return. Adding the prefix starts collecting new downloads but does not reconstruct historical activity.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Op3 MCP

conorbronsdon/op3-mcp is an MCP server that connects AI assistants to OP3 podcast analytics. Its main tools look up shows, retrieve monthly and weekly downloads, compare episode performance, list top apps and countries, and return raw download events. It is read-only and requires OP3-tracked downloads.

Install it through an MCP client using `npx -y @conorbronsdon/op3-mcp` and set `OP3_API_TOKEN` in the server environment. The README provides configurations for Claude Code and Claude Desktop. Node 18 or newer is required.

Call `op3_get_show` with the podcast's feed URL, podcast GUID, or an existing show UUID. The tool returns the OP3 show UUID, which most other analytics tools require. It can also include episode IDs, titles, and publication dates.

Listener geography is a representative sample, not an exact lifetime total. `op3_top_countries` aggregates raw OP3 records client-side, defaults to a 90-day window when no start date is given, and can be limited by `max_records`. Larger samples use more time and rate-limit capacity.

Related MCP servers

All in Podcasts All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOp3 MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/conorbronsdon-op3-mcp?style=directory)](https://allmcps.com/mcp/conorbronsdon-op3-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/conorbronsdon-op3-mcp"><img src="https://allmcps.com/api/badge/conorbronsdon-op3-mcp?style=directory" alt="Op3 MCP on AllMCPs" /></a>