Skip to content

Spoken

by spokenmd · remote · local (npm) · no sign-in to list tools · v0.4.3 · published by GitHub user spokenmd

Podcast transcripts as clean Markdown with real speaker names — via the Spoken API.

Changes · 2
CompareRegistry entry

8 tools: 2 change things and 6 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http spoken https://spoken.md/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

8 tools

Changes things 2Claude Code: ask
  • follow_podcastDeclare a follow for a show, or clear a mute.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Declare a follow for a show, or clear a mute. Pass a podcast_id from search_podcasts. A declared follow stays until unfollow_podcast, regardless of fetch activity, and does not use one of the five automatic slots. For a show never fetched, what counts as new starts from its newest episode now. Does not consume credits.

    Annotations the server declares

    • title: Follow a show
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • unfollow_podcastMute a show: it leaves the followed list and later fetches do not re-add it.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Mute a show: it leaves the followed list and later fetches do not re-add it. follow_podcast reverses it. Pass a podcast_id from list_following. Does not consume credits.

    Annotations the server declares

    • title: Stop following a show
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
Only reads 6Claude Code: allow
  • get_balanceCheck the current Spoken credit balance, account email, and recent usage for the configured API key.No findings

    Why it is in this group

    • The name "get_balance" says "get": a word for reading.
    Description, as the server wrote it
    Check the current Spoken credit balance, account email, and recent usage for the configured API key. Does not consume credits.

    Annotations the server declares

    • title: Get credit balance
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_transcriptFetch a podcast episode's transcript as clean Markdown with real speaker names and timestamps.No findings

    Why it is in this group

    • The name "get_transcript" says "get": a word for reading.
    Description, as the server wrote it
    Fetch a podcast episode's transcript as clean Markdown with real speaker names and timestamps. Pass an episode id from search_podcasts. Costs 1 credit on the first fetch of an episode; repeat fetches are free and errors are never charged.

    Annotations the server declares

    • title: Get transcript
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • list_episodesList a podcast's entire back-catalog (every episode, newest first).No findings

    Why it is in this group

    • The name "list_episodes" says "list": a word for reading.
    Description, as the server wrote it
    List a podcast's entire back-catalog (every episode, newest first). Pass a podcast_id from a search_podcasts result. Returns each episode's id, title, and date — fetch any with get_transcript. Use this to transcribe a whole show. Does not consume credits itself; transcribing the returned episodes costs 1 credit each (repeat fetches are free), so make sure the key has enough credits before looping.

    Annotations the server declares

    • title: List a show's episodes
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • list_followingThe shows this key is kept current on.No findings

    Why it is in this group

    • The name "list_following" says "list": a word for reading.
    Description, as the server wrote it
    The shows this key is kept current on. Every charged fetch makes its show a follow: the five most-fetched shows from the last 180 days are followed automatically (source 'fetch'), and up to 25 more can be declared with follow_podcast (source 'explicit'). Muted shows are listed separately. Use list_new_episodes to see what is new on them. Does not consume credits; the demo key has nothing to follow with.

    Annotations the server declares

    • title: List followed shows
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • list_new_episodesWhat is new on the shows this key follows: for each show, the episodes released in the last 90 days that are newer than the newest one already fetched from it (up to 10 per show), …No findings

    Why it is in this group

    • The name "list_new_episodes" says "list": a word for reading.
    Description, as the server wrote it
    What is new on the shows this key follows: for each show, the episodes released in the last 90 days that are newer than the newest one already fetched from it (up to 10 per show), each with a transcript_url. Episodes with no transcript are left out. Fetch any with get_transcript (1 credit each on first fetch); a fetch raises that show's floor, so the next call lists only what came after. Refreshed hourly, so a show followed moments ago may be empty until its first poll. Does not consume credits.

    Annotations the server declares

    • title: List new episodes on followed shows
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • search_podcastsSearch published podcast episodes by text query, or paste an episode URL (Spotify, YouTube, etc.).No findings

    Why it is in this group

    • The name "search_podcasts" says "search": a word for reading.
    Description, as the server wrote it
    Search published podcast episodes by text query, or paste an episode URL (Spotify, YouTube, etc.). Returns matching episodes with their id, title, podcast, podcast_id, and date. Use the id with get_transcript, or the podcast_id with list_episodes to get the show's whole back-catalog. Does not consume credits.

    Annotations the server declares

    • title: Search podcasts
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.4.3. Values in angle brackets are yours to fill in.

claude mcp add --transport http spoken https://spoken.md/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__spoken__search_podcasts",
      "mcp__spoken__get_transcript",
      "mcp__spoken__list_episodes",
      "mcp__spoken__get_balance",
      "mcp__spoken__list_following",
      "mcp__spoken__list_new_episodes"
    ],
    "ask": [
      "mcp__spoken__follow_podcast",
      "mcp__spoken__unfollow_podcast"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as spoken. Review it before you use it.