Skip to content

Connect an AI assistant (MCP)

PodcasterPlus runs a remote MCP server. MCP (Model Context Protocol) is the standard AI assistants use to connect to outside services, so once you connect PodcasterPlus you can ask your assistant about your own show and it reads the answer straight from your account.

Tested and working with Claude (web, desktop and Claude Code), Cursor, ChatGPT and Codex.

Ask things like:

  • "How did last week's episode do compared with my average?"
  • "Pull the three strongest moments from the transcript of episode 42."
  • "Who am I recording with tomorrow, and what did they say on the booking form?"
  • "Which of my booking links has brought in the most guests overall?"

MCP access is included on every paid plan.

What it can and cannot do

The connection is read-only. It can read:

  • your podcasts and the role you hold on each
  • episodes, including drafts and scheduled episodes
  • transcripts
  • download analytics for the show and for individual episodes
  • guests, upcoming recordings, and booking links

It cannot publish or schedule an episode, edit anything, send an invitation, change a booking, or spend AI credits. There is no write access at all, so nothing your assistant does can change your account.

Two deliberate exclusions: guest email and phone fields are never sent to an AI assistant, and the connection cannot reach the guest portal.

One thing worth knowing about free text. Guest biographies, your own notes, booking form answers and transcripts are sent as written, and we cannot tell a phone number typed into a notes field from any other sentence. Obvious contact details and links carrying an access token are stripped automatically, but if you keep something private in a notes field, assume an assistant you connect can read it.

Connect your assistant

The server address is:

https://mcp.podcasterplus.com/mcp

You will be asked to sign in to PodcasterPlus and approve the connection. Approve it only if you started it yourself.

Claude (claude.ai and the desktop app)

  1. Open Settings → Connectors → Add custom connector.
  2. Paste the server address above.
  3. Follow the prompts, then approve the connection on the PodcasterPlus page that opens.

The web and desktop apps share one connection, so authorising in either covers both.

Claude Code

bash
claude mcp add --transport http podcasterplus https://mcp.podcasterplus.com/mcp

Then run /mcp inside Claude Code and complete the sign-in when prompted.

Cursor

Add PodcasterPlus in Settings → MCP → Add new MCP server, choosing the HTTP transport and the address above.

ChatGPT and Codex

Add PodcasterPlus as a connector in ChatGPT's developer mode, or in the Codex desktop app, using the address above. Both share one connection: authorising in either covers the other.

What you are approving

The approval screen names the assistant that asked and lists what it can read. Two things worth knowing before you approve:

  • The connection acts as you, across every podcast you belong to on a paid plan. It cannot see podcasts you do not belong to.
  • Your PodcasterPlus password and session are never shared with the assistant. The assistant receives its own credential, which only works for the tools listed above and which you can revoke at any time.

Disconnect an assistant

Go to Settings → Connected AI clients. Every connection is listed with when it was connected and last used, and a Disconnect button. There is also Disconnect all AI clients.

Disconnecting takes effect immediately, on the connection's very next request.

Changing your password disconnects every AI client automatically. If you think an assistant has been connected without your knowledge, change your password: that revokes everything in one step.

Good practice

  • Connect only assistants you trust, on devices you control.
  • Transcripts and guest booking answers are written by other people. A well-behaved assistant treats them as information, not as instructions, and PodcasterPlus marks them as untrusted when it sends them. Still, be wary of any assistant that suddenly proposes an action you did not ask for after reading a transcript.
  • Review Settings → Connected AI clients occasionally and remove anything you no longer use.

Tool reference

These are the tools your assistant can use. You never call them by name yourself: the assistant picks the right one from what you ask. They are listed so you know exactly what a connected assistant can and cannot see.

ToolWhat it does
list_podcastsLists the podcasts you can access and the role you hold on each. Only podcasts on accounts whose plan includes MCP appear.
podcast_overviewPodcast details plus headline download figures for a period (7 days, 30 days, 90 days, 12 months, or all time).
list_episodesYour episodes, newest first, filterable by status: draft, scheduled, published or archived.
episode_briefOne episode in a single call: its details, the people on it, its download figures, and whether a transcript exists.
get_transcriptReads a transcript in segments. Long episodes come back in pieces rather than all at once.
upcoming_recordingsConfirmed and pending recordings still to come, with guest names, booking-form answers and notes.
list_guestsGuests associated with a podcast, with their biography and your private notes.
list_booking_linksYour booking links with their settings and total bookings to date.

This list is a contract, not a snapshot. New tools can appear without notice, but a tool will not be renamed or removed, and its inputs will not be narrowed, without a deprecation notice first. That is the same promise the public API versioning policy makes.

Two things no tool can do: return a guest's email or phone field, and reach the guest portal. As above, free text is different: a phone number typed into a notes field is just text, and we cannot tell it apart from any other sentence.

When a tool declines

Some replies are refusals rather than data, and each carries a stable code your assistant may show you:

CodeMeaning
no_entitled_podcastsNone of your podcasts sit on an account whose plan includes MCP access.

Limits

Requests are rate limited per account. A normal conversation will never reach the limit; an assistant stuck in a loop will, and it will be told to slow down rather than being disconnected.

Transcripts are returned in segments rather than all at once, so an assistant reading a long episode fetches it in pieces.

Was this page helpful?