Spoken MCP server
online · 100% uptimeio.github.spokenmd/spoken·v0.4.3·5 starsPodcast transcripts as clean Markdown with real speaker names — via the Spoken API.
5 stars138 downloads/wk
Reviews
Write oneNobody has reviewed Spoken yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Spoken tools (8)
write = sends, deletes, buys or postsfollow_podcastFreeDeclare 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.
get_balanceFreeCheck the current Spoken credit balance, account email, and recent usage for the configured API key. Does not consume credits.
get_transcriptFreeFetch 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.
list_episodesFreeList 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.
list_followingFreeThe 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.
list_new_episodesFreeWhat 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.
search_podcastsFreeSearch 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.
unfollow_podcastFreeMute 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.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- Live reliabilityremote reachable in 1722ms20/20
- Tool poisoning8 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 28 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How Spoken compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 90/100
- higher than 82% of 1,331 Media servers
- Tools
- 8
- the typical Media server has 7
- Tools that change things
- 0%
- typical: 6%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Media server answers 100%
- Response time
- 259 ms
- faster than 54% of 860 Media servers
- GitHub stars
- 5
- more than 82% of 727 Media servers
- Downloads a week
- 138
- more than 66% of 422 Media servers with a package
What its tools let an agent do: 8 read
Release history: 3 versions in the registry since 2026-08-12, latest 2026-10-06, typically one every 43 days.
Install Spoken in Claude Code, Cursor or VS Code
claude mcp add --transport http spoken https://spoken.md/mcp
What the publisher says
From the Spoken repository's README, as published. We do not edit it. Read it on GitHub
Spoken — podcast transcript API and MCP server, clean Markdown with real speaker names
Spoken is a transcript API that turns any published podcast into clean Markdown with real speaker names — not "Speaker 1." One API call returns named, timestamped text, ready for LLMs, RAG pipelines, summarizers, and search. This repo also ships spoken-mcp, an MCP server that gives Claude Desktop, Claude Code, Cursor and Cline the same transcripts as tools — see Use as an MCP server.
It's a transcript retrieval API, not a speech-to-text service: it works on already-published podcasts, so you skip uploading audio, running diarization, and mapping anonymous speaker labels by hand. For published shows that's typically 5–10× cheaper than running the audio through a transcription service.
- 🎙️ Real speaker names, resolved automatically
- 📄 Clean Markdown with timestamps, tuned for LLM context windows and RAG chunking
- 🔎 Search by text query or paste a Spotify/YouTube URL
- 💳 Pay-per-use credits — no subscription, failed calls never charged, repeat fetches free
- 🤖 Agent-native — ships with an Agent Skill, agents.md, llms.txt, and an OpenAPI spec
Get a key at spoken.md — or try it free with the demo key pt_demo (search works fully; transcripts limited to the demo episode).
Quickstart
# 1. Find an episode (by text, or paste a Spotify/YouTube URL)
curl -s 'https://spoken.md/search?q=huberman+sleep' \
-H 'x-api-key: pt_demo'
# 2. Fetch the transcript as Markdown
curl -s 'https://spoken.md/transcripts/1000651996090' \
-H 'x-api-key: pt_demo'The transcript comes back as Markdown with named speakers and timestamps:
**John Smith** (0:00)
Welcome to the show. Today we're talking about...
**Jane Doe** (0:15)
Thanks for having me.Endpoints
Auth is the x-api-key header. Responses include X-Credits-Remaining and X-Credits-Charged. See agents.md for the full error table and response shapes.
Examples
- examples/podcast_summarizer.py — fetch a transcript and summarize it
- examples/rag_pipeline.py — chunk a transcript for a vector store / RAG
- examples/quickstart.sh — search → transcript in two curl calls
- examples/archive-show.sh — archive a show's entire back catalogue, one file per episode
Use from Python
The spoken-md package wraps the API with no dependencies outside the standard library, and installs a spoken-md command.
pip install spoken-mdfrom spoken_md import Spoken
spoken = Spoken() # SPOKEN_API_KEY, or the demo key
episode = spoken.search("huberman sleep")[0]
print(spoken.transcript(episode.id)) # Markdown with real speaker namesarchive(podcast_id, skip=...) walks a whole show and is resumable; errors are typed by status (PaymentRequired carries the top-up URL, NotFound means no transcript). See python/README.md.
Use as an MCP server
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Grade history
- 2026-11-03restoreB → Ascore 90
Spoken: common questions
- Is Spoken MCP server safe?
- Yes, by our scan: it is graded A (90/100). Read the Spoken safety report
- How do I install Spoken?
- It runs remotely at spoken.md. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Spoken need an API key?
- Yes. The registry entry asks for
SPOKEN_API_KEY,Authorization. - Is Spoken maintained?
- The last commit was 40 days ago (2026-10-06). The latest release is v0.4.3.
- Is Spoken up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Spoken?
- Servers from other publishers that do the same job: anymd MCP server, Katto MCP server and Remove AI Watermarks MCP server.
- How does Spoken compare with other Media MCP servers?
- safety score 90/100 (higher than 82% of 1,331 Media servers); tools 8 (the typical Media server has 7); tools that change things 0% (typical: 6%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Spoken
Same job from other publishers: the closest match first, then the best rated.
- anymdAny file → clean Markdown for AI agents: PDF, Office, EPUB, HTML, images, audio/video. Local MCP.not reviewedEstablishedA
- KattoAI video clipping MCP: long videos and podcasts into scored, captioned 9:16 shorts.5.0(1)GrowingB
- Remove AI WatermarksIdentify and clean AI watermarks and provenance in your own images, video, and text.not reviewedWidely usedA
CartCutEdit video in the CartCut desktop editor: cuts from a transcript, captions, motion, effects.not reviewedEstablishedA- Youtube TranscriptThis is an MCP server that allows you to directly download transcripts of YouTube videos.not reviewedEstablishedB