Connect your agent

Choose your client and sign in. Every connection uses the same tldw.sh account and credits.

Create an account to save summaries and connect your agents.

Connect your client

// CHOOSE YOUR CLIENT

How will you use tldw.sh?

Sign in from your client. Your saved transcripts, summaries and credits work across connections.

Run /mcp, select tldw, and complete browser sign-in.

Claude Code · sign in with OAuth
claude mcp add --transport http tldw 'https://api.tldw.sh/mcp'
claude plugin install tldw --marketplace tldwdotsh/tldw-agent-plugin

Server URL: https://api.tldw.sh/mcp. Connection checks do not start processing. Preserve existing client settings and approve the requested access. Manage connected apps.

Official client setup

Complete browser sign-in and approve the requested access. API keys are an alternative for scripts or headless clients. Manage connected apps in Settings.

Have a link? Try one of these

Paste a public YouTube or X link into your agent, then one of these. Your agent keeps the job ID, waits for the job and reads the summary and original transcript. list_transcripts browses your saved sources, which you can read again without another job or charge.

YouTube research brief

Main argument and three useful takeaways. Cite the minute for each.

1 credit per caption minute. A 20-minute talk is 20 credits. Reading the saved result again is free.

Summary and transcript

Summarize this video, then retrieve its original transcript.

Standard credit rates cover both outputs. Reading them again is free.

Claims and evidence

List practical claims, the evidence, and the caveats. Flag anything supported by one example.

Same caption rate: 1 credit per caption minute. Captions or a saved transcript are required; missing captions fail without a processing-credit charge. Fresh audio transcription is unavailable.

Limits and credits

Agents cannot buy credits. The connector, Claude Code, the skill and the SDKs use the same tldw.sh account and credits; a new API key does not add free credits. Captions or a saved transcript cost 1 credit per minute, and reading saved results uses none. Live pricing & limits

Fallback downloads and machine docs

Install without npm or PyPI: each command downloads the versioned file, stops unless its SHA-256 matches this release, then installs the verified local file.

JavaScript client (verified download)
Loading the command for this deployment…
Python client (verified download)
Loading the command for this deployment…

Node.js 20.11 or newer. This prepares the plugin in a new local directory and prints the client-specific commands. It preserves existing agent configuration.

Install the plugin locally
Loading the command for this deployment…

OAuth users can call account_usage in their connected client. The CLI uses a separate API key: with TLDW_API_TOKEN set, doctorchecks account access, MCP discovery and a read-only tool. It doesn’t submit media or use credits.

API-key connection check
Loading the command for this deployment…
Agent onboarding URL
Loading the command for this deployment…

Standard scopes: account:readjobs:writejobs:readsummaries:read. Creating or rotating credentials never resets free usage.

Additional install options

  1. Connect Claude
    https://api.tldw.sh/mcp

    In Claude, open Customize → Connectors → Add custom connector, paste this URL, then sign in to tldw.sh.

  2. Connect Claude Code
    claude mcp add --transport http tldw 'https://api.tldw.sh/mcp'

    Open /mcp and sign in to tldw.sh. Choose your client below for Codex, Cursor, OpenCode, VS Code / Copilot or Grok Build.

  3. Add the skill
    https://tldw.sh/agent-onboarding/SKILL.md

    Give your agent this URL. The skill ZIP is in the fallback downloads.

  4. Python SDK
    python -m pip install tldw-client==0.2.13

    Import TldwClient from tldw_client. Checksum-verified downloads remain available.

  5. JavaScript SDK
    npm install @tldw/client@0.2.13

    Node.js 20.11 or newer. Import TldwClient from @tldw/client. Checksum-verified downloads remain available.