Pepys-mcp Server

Transcription for AI agents, by Pepys.

Local + remotestreamable-httpstdioMIT

What is the Pepys-mcp Server?

pepys-mcp is an MCP project maintained in the ankurmans/pepys-mcp repository. The maintainer describes its purpose as “Transcription for AI agents, by Pepys”. Read the project documentation for the complete scope.

Installation

The documented npm package is pepys-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares PEPYS_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
transcribeStart a transcription from a url (file / YouTube / podcast / Drive) or a file_ref. Options: diarize (entitlement required), summary, chapters, translate_to…
get_transcriptionFetch a job by job_id; set wait_ms:25000 to long-poll short clips to completion in one call.
upload_fileUpload local media (a path or bytes_base64) → a file_ref for transcribe.
list_transcriptionsRecent jobs (id, status, title, minutes).
list_podcast_episodesEpisodes of an RSS/Apple/Spotify feed, with episode_guids.
transcribe_podcast_feedBatch a whole feed (or latest N). Account entitlement required.
export_transcriptExport SRT / VTT / TXT / MD / JSON. Word-level timing requires an account entitlement. (DOCX/PDF: use the web app.)
search_transcriptFind a phrase in a long transcript → only the matching timestamped segments (no full-transcript context load).
ask_transcriptionAnswer a question about a transcript with server-verified, citation-backed claims only.
get_credit_balanceRemaining transcription balance and entitlement state.

How to install the Pepys-mcp Server

{
  "mcpServers": {
    "pepys": {
      "command": "npx",
      "args": [
        "-y",
        "pepys-mcp"
      ],
      "env": {
        "PEPYS_API_KEY": "YOUR_PEPYS_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
PEPYS_API_KEYDeclared in the maintainer’s client configuration.Check documentation