speech-to-texttranscriptionpodcastscaptionsaudio
Transcribe audio, video, YouTube links, and podcast feeds with diarization, timestamps, search, and caption exports.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
This server is confirmed live — we successfully called its tools/list endpoint directly (see the verified badge above). We haven't yet sandbox-tested the stdio install command below specifically, which is a separate, ongoing check.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Transcribe long audio or video recordings
Identify speakers and generate diarized transcripts
Select and transcribe podcast episodes from RSS or Apple Podcasts
Export timestamped captions in SRT or VTT format
Search long transcripts for timestamped quotes or topics
Key features
Audio and video transcription from files or URLs
Speaker diarization and timestamped segments
Podcast episode listing and feed batch transcription
SRT, VTT, TXT, Markdown, and JSON export
Transcript search with matching timestamped segments
Credit balance and transcription job management
Capabilities & Tool Schemas (9)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Pepys MCP.
transcribeTranscribe hours-long audio or video into an accurate, speaker-labeled (diarized), timestamped transcript with correctly-timed SRT/VTT captions – work a general model can't do on a raw file. Accepts a file_ref from upload_file or a url (YouTube, podcast episode, RSS feed, Google Drive/Dropbox share). Audio is never used to train models. Returns { job_id, status }; fetch the result with get_transcription.
get_transcriptionFetch a transcription by job_id: full text, per-speaker timestamped segments, summary, duration_seconds, billed_minutes, and language. Set wait_ms (up to 25000) to long-poll so short clips come back in one call; otherwise poll until status is 'done'.
upload_fileUpload local audio/video the agent is holding (as base64 bytes or a file path) and get back a file_ref to pass to transcribe. Use this when the media has no public URL. Requires the Pepys R2 storage backend.
list_transcriptionsList this account's recent transcription jobs with their job_id, status, title, and duration, so you can resume, fetch, or export an earlier result instead of re-transcribing.
list_podcast_episodesGiven a podcast RSS feed or Apple Podcasts show URL, list its episodes (title, publish date, episode_guid, audio_url) so you can pick exactly which one to transcribe.
transcribe_podcast_feedBatch-transcribe a whole podcast feed in one call – fan out every episode, or the latest N, to individual jobs. Returns a set of job_ids. Paid capability (throughput/abuse gate).
Documentation Overview
pepys-mcp
Transcription for AI agents, by Pepys – pay-once audio & video transcription at pepys.co.
The Pepys transcription MCP server – give any MCP-speaking agent (Claude, ChatGPT, Cursor, Gemini, open-source agents) accurate, speaker-labeled, timestamped transcription of hours-long audio and video: diarization, correctly-timed SRT/VTT captions, paste-a-link ingestion (YouTube, podcasts, Drive/Dropbox), batch, and word-level export – work a general model can't do on a raw file. Pepys never trains on your audio.
Thin stdio wrapper over the Pepys v1 REST API. Phase-1 (BYO-key). OAuth/remote is on the roadmap.
Install & configure
Requires Node ≥ 18 and a Pepys API key (pk_live_…) from https://pepys.co/developers. You get 60 free minutes on signup – no card. Buy any pack once to unlock diarization, batch, and word-level export.
Run it with npx (no global install):
Claude Desktop / Claude Code – claude_desktop_config.json (or claude mcp add):
Cursor – ~/.cursor/mcp.json, same shape. Windsurf / other dev agents – point them at npx -y pepys-mcp with PEPYS_API_KEY in the env.
Optional env: PEPYS_API_BASE (defaults to https://pepys.co/api/v1).
Tools
| Tool | What it does |
|---|---|
transcribe | Start a transcription from a url (file / YouTube / podcast / Drive) or a file_ref. Options: diarize (paid), summary, chapters, translate_to, quality, podcast episode_guid/episode_index. Returns { job_id, status }. |
get_transcription | Fetch a job by job_id; set wait_ms:25000 to long-poll short clips to completion in one call. |
upload_file | Upload local media (a path or bytes_base64) → a file_ref for transcribe. |
list_transcriptions | Recent jobs (id, status, title, minutes). |
list_podcast_episodes | Episodes of an RSS/Apple/Spotify feed, with episode_guids. |
transcribe_podcast_feed | Batch a whole feed (or latest N). Paid. |
export_transcript | Export SRT / VTT / TXT / MD / JSON. Segment-level is free; word_level:true is a paid unlock. (DOCX/PDF: use the web app.) |
search_transcript | Find a phrase in a long transcript → only the matching timestamped segments (no full-transcript context load). |
get_credit_balance | Remaining credit minutes + whether Pro is unlocked. |
Also exposes finished transcripts as the resource pepys://transcription/{id} and a transcribe_and_summarize prompt.
Billing over MCP: two graceful prompts – 402 (out of minutes → top up at pepys.co/billing) and a Pro-feature upgrade message (diarization / batch / word-level → unlock with any one-time purchase). Segment exports, single transcription, links, and uploads are free on your minutes.
Develop
Publish
npm run build && npm publish (publishes pepys-mcp). Registry listings (MCP registry, mcp.so, Smithery, PulseMCP, Glama, awesome-mcp-servers) are submitted separately.
About
Built by Pepys – pay-once, usage-based transcription for audio and video (no subscription, credits never expire). Learn more at pepys.co · MCP server · Developer docs · Pricing.
License
MIT
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
npm downloads
254
Package downloads in the last 30 days.
Last commit
2mo ago
Most recent push to the default branch.
Tools exposed
9
Callable tools this server registers over MCP.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Pepys MCP
AllMCPs Directory Badge
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 Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/ankurmans-pepys-mcp)HTML Embed
<a href="https://allmcps.com/mcp/ankurmans-pepys-mcp"><img src="https://allmcps.com/api/badge/ankurmans-pepys-mcp?style=directory" alt="Pepys MCP on AllMCPs" /></a>