PodcastsToText

Transcription API
for podcasts, YouTube and TikTok.

POST a link, take a webhook, pull JSON, SRT, VTT, DOCX or PDF — plus chapters, show notes and translations from the same transcript. Over HTTP, or over MCP.

  • Scoped bearer keys
  • Signed webhooks
  • OpenAPI 3.1 spec
  • No SDK to install
Get a key from $14.00/mo View docs

Agent keys spend credits and can publish public pages. Scope the key you hand one.

Made from the transcript
Drive it headless
REST

One call in, one id back

Request
curl -X POST https://podcaststotext.com/api/v1/transcriptions \
  -H "Authorization: Bearer ptt_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://open.spotify.com/episode/4rOoJ6..."}'
Response
202 Accepted

{
  "id": "8f3c8e21-4b7a-4c19-9f2e-1d8a6c3b5e07",
  "status": "processing",
  "source_type": "spotify",
  "next_actions": [
    "GET /api/v1/transcriptions/8f3c... to check status"
  ]
}

Poll that id or register a webhook. ?include=text for the body, ?format=srt for a file. Full reference in the docs.

MCP

Connect an agent

One command. No SDK, no config file.

Terminal
# 1 · Connect the server
claude mcp add --transport http podcaststotext https://podcaststotext.com/api/mcp \
  --header "Authorization: Bearer ptt_your_key_here"

# 2 · Or bridge it locally, for stdio-only clients
PODCASTSTOTEXT_API_KEY=ptt_your_key npx -y podcaststotext-mcp

# 3 · Then ask, in the assistant:
#   "Transcribe the latest Hard Fork episode and give me chapters"

# Optional · the calling order, not just the tool list
npx skills add marstyl99/podcaststotext-agent

/mcp has the exact config for each client.

For agents

The same key drives MCP

13 tools, under the same scopes and limits.

Remote MCP

Point Claude, Cursor, VS Code or Windsurf at /api/mcp with your key; the 13 tools appear.

Local bridge

podcaststotext-mcp on npm bridges the same endpoint for stdio-only clients. Most clients do not need it.

The agent skill

Calling order, what spends credits, and which refusals are instructions — the part a tool list does not carry.

All 13 tools podcaststotext-mcp on npmOpenAPI spec
FAQ

API questions

Yes. The API and the MCP server are on Creator, Pro, Studio and Podmaxxing The free tier is for trying the studio, not the API. The entry plan raises the monthly allowance and the rate limits and unlocks the AI tools; extra API minutes are sold in packs, spendable while your plan includes API access, and paused rather than lost if you cancel.

Get a key and make the first call

The API and the MCP server are on Creator, Pro, Studio and Podmaxxing. Keys are scoped and revocable, and one key drives REST and MCP alike.