conorbronsdon/op3-mcp

Podcast analytics for AI agents through OP3: downloads over time, listener geography, apps, and per-episode breakdowns. Read-only.
---
An MCP server for OP3, the Open Podcast Prefix Project. It gives AI assistants podcast analytics that most hosting APIs do not expose: downloads over time, listener geography, the apps people listen in, and per-episode breakdowns.
**Read-only by design.** OP3 is an analytics service. This server only reads data. It cannot change anything, so it is safe to give an agent.
**Why this exists.** Most podcast hosts expose almost nothing through their API. Transistor's API, for example, returns download counts and not much else: no geography, no app share, no per-episode recency curve. OP3 has all of that, because it logs each download at the redirect. This server puts that data in front of an agent.
What is OP3?
OP3 is a free, open analytics prefix for podcasts. You add https://op3.dev/e/ in front of your enclosure URLs, and OP3 logs each download before redirecting to your real audio file. It then reports downloads, geography, and app share. Stats pages are public; the API needs a token. See https://op3.dev for details.
If your feed does not use the OP3 prefix yet, OP3 has no data for it. See "Adding the OP3 prefix" below.
Tools
| Tool | What it returns | OP3 endpoint |
|------|-----------------|--------------|
| op3_get_show | Show UUID, title, podcast GUID, stats page URL, optional episode list | GET /shows/{showUuidOrPodcastGuidOrFeedUrlBase64} |
| op3_show_downloads | Monthly downloads, weekly breakdown, weekly average | GET /queries/show-download-counts |
| op3_episode_downloads | Per-episode downloads at 1/3/7/30 days and all-time | GET /queries/episode-download-counts |
| op3_top_apps | Top apps/players by download share, last 3 calendar months | GET /queries/top-apps-for-show |
| op3_top_countries | Top listener countries or regions (computed from raw records) | GET /downloads/show/{showUuid} |
| op3_downloads_timeseries | Raw download events over a date range (time, country, app, device) | GET /downloads/show/{showUuid} |
Most tools need a show UUID. Start with op3_get_show to turn a feed URL or podcast GUID into a UUID.
Every list tool takes a limit and defaults it low (10) to keep responses small. Agents pay tokens per response.
Setup
1. Get a token
1. Go to https://op3.dev and sign in.
2. Open your API token page and copy the token.
3. For trying things out, OP3 also publishes a shared preview token, preview07ce, which works against public shows.
2. Find your show UUID
If you know your feed URL or podcast GUID, ask the assistant to run op3_get_show with it and it will return your UUID. You can also read the UUID from your show's OP3 stats page URL: https://op3.dev/show/{showUuid}.
3. Configure your MCP client
Claude Code
Add to your .mcp.json:
Claude Desktop
Add to your claude_desktop_config.json:
4. Verify
Ask your assistant: "Look up my show on OP3" with your feed URL, then "How many downloads did it get last month?"
Adding the OP3 prefix (if you are not on OP3 yet)
OP3 only has data once downloads route through its prefix. To start:
1. In your podcast host, prepend https://op3.dev/e/ to your episode audio URLs. Many hosts (Transistor, Buzzsprout, and others) have a one-click OP3 toggle. Check your host's settings for an "OP3" or "analytics prefix" option.
2. New downloads will start being logged. Historical downloads from before you added the prefix are not backfilled.