MCP Transcript Workflows

Scority provides the transcript endpoint that MCP-style tools need: a protected action for YouTube transcript text and timestamped segments.

View API docs Get API access

Current scope

One real transcript tool.

The local MCP wrapper should stay aligned with the production API. It fetches transcripts by video ID or URL and leaves search, channels, uploads, billing and dashboard work out of scope.

Tool: get_youtube_transcript
Transport: stdio for local MCP clients
API: GET /v1/youtube/transcript
Auth: SCORITY_API_KEY from environment variables
Base URL: SCORITY_API_BASE_URL, defaulting to https://api.scority.ai
Stable path for production apps: HTTP API and OpenAPI

Local configuration.

For local agents, build the repository package and point your MCP client at the compiled stdio entry. Keep the API key in the MCP client environment and do not pass it as a CLI argument.

claude_desktop_config.json

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

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

claude_desktop_config.json11 lines

Tool shape.

Provide exactly one of video_id or video_url. The optional language parameter maps directly to the Scority Transcript API.

get_youtube_transcript.json

{
  "name": "get_youtube_transcript",
  "input": {
    "video_id": "dQw4w9WgXcQ",
    "language": "en"
  },
  "output": {
    "text": "...",
    "language": "en",
    "source": "captions",
    "segments": [
      { "text": "...", "start": 0, "duration": 2.3 }
    ],
    "segment_count": 61,
    "text_length": 2165
  }
}

{
  "name": "get_youtube_transcript",
  "input": {
    "video_id": "dQw4w9WgXcQ",
    "language": "en"
  },
  "output": {
    "text": "...",
    "language": "en",
    "source": "captions",
    "segments": [
      { "text": "...", "start": 0, "duration": 2.3 }
    ],
    "segment_count": 61,
    "text_length": 2165
  }
}

get_youtube_transcript.json17 lines

Scope boundaries

Keep the tool narrow.

Use the HTTP API and OpenAPI spec for production services.
Use the repository MCP wrapper for local/internal agent workflows.
Use static API-key configuration for local stdio clients.
Expose only get_youtube_transcript.
Handle transcript_not_available and upstream_transcript_failed.