Scority

YouTube Transcript API for Claude Workflows

Use Scority transcript data in Claude-style workflows through server-side API calls or a local MCP-style wrapper around the same endpoint.

Read MCP notesAPI reference
Direct answer

Claude workflows should call the transcript API safely

The stable integration path is a server-side call to https://api.scority.ai/v1/youtube/transcript. A local MCP-style wrapper can use the same contract when you want Claude Desktop to call a transcript tool.

  • Keep SCORITY_API_KEY in server-side configuration.
  • Use one transcript action: get a transcript by video_id or video_url, with optional language.
  • Do not expose keys in browser code, prompt text, shared screenshots, or public config files.
  • Use the HTTP API and OpenAPI spec as the production source of truth.
HTTP path

Use the current public API contract

For most teams, the cleanest Claude workflow is an internal tool or server route that calls Scority and returns only the transcript text and segments needed by the assistant.

Endpoint

GET /v1/youtube/transcript on https://api.scority.ai.

Open →

Authentication

Send x-api-key from server-side code. Do not put the key in Claude instructions.

Open →

OpenAPI

Use the OpenAPI spec to inspect response schemas and error codes.

Open →
Local tool

Local MCP-style tool shape

A local wrapper should expose one real tool, get_youtube_transcript, backed by the Scority Transcript API. Keep it narrow so Claude receives transcript data without extra product surfaces.

  • Tool input: video_id or video_url, plus optional language.
  • Tool output: text, language, source, segments, segment_count, and text_length.
  • No dashboard, billing, channel, upload, search, or playlist tools are exposed.
  • Use a repository build path instead of a public package install command.
Example

Local Claude Desktop config shape

Replace the path with the built local tool location on your machine and provide the API key through the environment.

{
  "mcpServers": {
    "scority": {
      "command": "node",
      "args": [
        "/absolute/path/to/scority/packages/scority-mcp/dist/index.js"
      ],
      "env": {
        "SCORITY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
Scope

Keep Claude focused on transcript retrieval

This integration should point users to the real transcript API contract. Do not add public package installs, speech-to-text guarantees, search tools, channel tools, billing tools, or dashboard tools to the Claude setup.

MCP integration notes

Read the broader MCP workflow notes and local tool shape.

Open →

Error handling

Handle unauthorized, rate_limited, quota_exceeded, transcript_not_available, and upstream_transcript_failed.

Open →

Language options

Use language or lang for language selection, but do not send both.

Open →