{"schema_version":1,"name":"tldw.sh","client_version":"0.2.13","description":"Analyze supplied media with optional custom instructions; preserve the durable job ID and retrieve cited output.","api_url":"https://api.tldw.sh","mcp_url":"https://api.tldw.sh/mcp","authentication":{"type":"bearer","scopes":["account:read","jobs:write","jobs:read","summaries:read"],"setup_url":"https://tldw.sh/agents","human_verification":"one_time_in_browser","api_calls":"headless","recommended_method":"oauth_authorization_code_pkce","methods":["oauth_authorization_code_pkce","personal_api_key"],"oauth":{"protected_resource_metadata_url":"https://api.tldw.sh/.well-known/oauth-protected-resource/mcp","authorization_server_metadata_url":"https://api.tldw.sh/.well-known/oauth-authorization-server","resource":"https://api.tldw.sh/mcp","code_challenge_method":"S256","offline_access_scope":"offline_access","consent":"explicit_account_owner_approval","discovery":"read_live_metadata; availability_and_client_registration_follow_operator_policy","connections_url":"https://tldw.sh/settings#connected-apps"}},"onboarding_skill":"https://tldw.sh/agent-onboarding/SKILL.md","chat_connectors":[{"id":"claude","name":"Claude","mcp_url":"https://api.tldw.sh/mcp","setup_url":"https://claude.ai/","documentation_url":"https://claude.com/docs/connectors/custom/add-unlisted","authentication":"oauth","steps":["In Claude web or Desktop, open Customize → Connectors → Add custom connector.","Name it tldw.sh and enter the MCP server URL below.","Choose Sign in now and Register automatically if asked for authentication settings.","Connect, sign in to tldw.sh and review the requested permissions. No API key or OAuth client secret is needed."],"note":"Available controls depend on your Claude account and workspace. In Team/Enterprise, an owner adds the connector and members sign in to their own tldw.sh accounts. Claude Code uses the Coding agents setup."},{"id":"chatgpt","name":"ChatGPT","mcp_url":"https://api.tldw.sh/mcp","setup_url":"https://chatgpt.com/plugins","documentation_url":"https://developers.openai.com/plugins/build/plugins","authentication":"oauth","steps":["Open ChatGPT Plugins, choose the plus button, then Add custom MCP server.","Enter the MCP server URL below and choose OAuth for authentication.","Review the custom-server risk warning and choose Create as plugin.","Sign in to tldw.sh and review the requested permissions. OAuth discovery registers the connection automatically; no API key or client secret is needed."],"note":"Custom plugin availability depends on your plan/workspace policy; an admin may need to enable it. Codex uses the Coding agents setup."},{"id":"grok","name":"Grok","mcp_url":"https://api.tldw.sh/mcp","setup_url":"https://grok.com/connectors","documentation_url":"https://docs.x.ai/grok/connectors","authentication":"oauth","steps":["Open Grok Connectors, choose New Connector, then Custom.","Enter the MCP server URL below.","Complete the required browser authentication with tldw.sh and review the requested permissions."],"note":"Business and Enterprise teams need an admin to provision the connector first in console.x.ai → Grok Business → Connectors → Add Connector → Other. Grok Build uses the Coding agents setup."}],"clients":[{"id":"claude_code","name":"Claude Code","configuration_file":".mcp.json","documentation_url":"https://code.claude.com/docs/en/mcp","oauth":{"id":"claude_code","label":"Claude Code","source":"https://code.claude.com/docs/en/mcp","file":".mcp.json","signIn":"Run /mcp, select tldw, and complete browser sign-in.","code":"claude mcp add --transport http tldw 'https://api.tldw.sh/mcp'","title":"Claude Code · sign in with OAuth","description":"Run /mcp, select tldw, and complete browser sign-in."},"api_key_alternative":{"id":"claude_code","label":"Claude Code","source":"https://code.claude.com/docs/en/mcp","file":".mcp.json","signIn":"Run /mcp, select tldw, and complete browser sign-in.","code":"{\n  \"mcpServers\": {\n    \"tldw\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.tldw.sh/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${TLDW_API_TOKEN}\"\n      }\n    }\n  }\n}","title":"Claude Code · API-key alternative","description":"Use .mcp.json with TLDW_API_TOKEN supplied privately by the client environment. Preserve existing servers. Keep the key out of this snippet and conversations."},"plugin":{"repository":"https://github.com/tldwdotsh/tldw-agent-plugin","command":"claude plugin install tldw --marketplace tldwdotsh/tldw-agent-plugin"}},{"id":"codex","name":"Codex","configuration_file":"config.toml","documentation_url":"https://developers.openai.com/codex/mcp","oauth":{"id":"codex","label":"Codex","source":"https://developers.openai.com/codex/mcp","file":"config.toml","signIn":"Merge this table into your Codex config.toml, then run codex mcp login tldw.","code":"[mcp_servers.tldw]\nurl = \"https://api.tldw.sh/mcp\"","title":"Codex · sign in with OAuth","description":"Merge this table into your Codex config.toml, then run codex mcp login tldw."},"api_key_alternative":{"id":"codex","label":"Codex","source":"https://developers.openai.com/codex/mcp","file":"config.toml","signIn":"Merge this table into your Codex config.toml, then run codex mcp login tldw.","code":"[mcp_servers.tldw]\nurl = \"https://api.tldw.sh/mcp\"\nbearer_token_env_var = \"TLDW_API_TOKEN\"","title":"Codex · API-key alternative","description":"Use config.toml with TLDW_API_TOKEN supplied privately by the client environment. Preserve existing servers. Keep the key out of this snippet and conversations."},"plugin":{"repository":"https://github.com/tldwdotsh/tldw-agent-plugin","command":"codex plugin marketplace add tldwdotsh/tldw-agent-plugin\ncodex plugin add tldw@tldw"}},{"id":"cursor","name":"Cursor","configuration_file":".cursor/mcp.json","documentation_url":"https://cursor.com/docs/mcp","oauth":{"id":"cursor","label":"Cursor","source":"https://cursor.com/docs/mcp","file":".cursor/mcp.json","signIn":"Merge into your project's .cursor/mcp.json, enable tldw in Customize, and sign in.","code":"{\n  \"mcpServers\": {\n    \"tldw\": {\n      \"url\": \"https://api.tldw.sh/mcp\"\n    }\n  }\n}","title":"Cursor · sign in with OAuth","description":"Merge into your project's .cursor/mcp.json, enable tldw in Customize, and sign in."},"api_key_alternative":{"id":"cursor","label":"Cursor","source":"https://cursor.com/docs/mcp","file":".cursor/mcp.json","signIn":"Merge into your project's .cursor/mcp.json, enable tldw in Customize, and sign in.","code":"{\n  \"mcpServers\": {\n    \"tldw\": {\n      \"url\": \"https://api.tldw.sh/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${env:TLDW_API_TOKEN}\"\n      }\n    }\n  }\n}","title":"Cursor · API-key alternative","description":"Use .cursor/mcp.json with TLDW_API_TOKEN supplied privately by the client environment. Preserve existing servers. Keep the key out of this snippet and conversations."},"plugin":{"repository":"https://github.com/tldwdotsh/tldw-agent-plugin","command":null}},{"id":"opencode","name":"OpenCode","configuration_file":"opencode.json","documentation_url":"https://opencode.ai/docs/mcp-servers/","oauth":{"id":"opencode","label":"OpenCode","source":"https://opencode.ai/docs/mcp-servers/","file":"opencode.json","signIn":"Merge into OpenCode V2's opencode.json, then run opencode mcp auth tldw.","code":"{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"servers\": {\n      \"tldw\": {\n        \"type\": \"remote\",\n        \"url\": \"https://api.tldw.sh/mcp\"\n      }\n    }\n  }\n}","title":"OpenCode · sign in with OAuth","description":"Merge into OpenCode V2's opencode.json, then run opencode mcp auth tldw."},"api_key_alternative":{"id":"opencode","label":"OpenCode","source":"https://opencode.ai/docs/mcp-servers/","file":"opencode.json","signIn":"Merge into OpenCode V2's opencode.json, then run opencode mcp auth tldw.","code":"{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"servers\": {\n      \"tldw\": {\n        \"type\": \"remote\",\n        \"url\": \"https://api.tldw.sh/mcp\",\n        \"oauth\": false,\n        \"headers\": {\n          \"Authorization\": \"Bearer {env:TLDW_API_TOKEN}\"\n        }\n      }\n    }\n  }\n}","title":"OpenCode · API-key alternative","description":"Use opencode.json with TLDW_API_TOKEN supplied privately by the client environment. Preserve existing servers. Keep the key out of this snippet and conversations."},"plugin":null},{"id":"vscode","name":"VS Code / Copilot","configuration_file":"~/.copilot/mcp-config.json","documentation_url":"https://code.visualstudio.com/docs/agents/reference/mcp-configuration","oauth":{"id":"vscode","label":"VS Code / Copilot","source":"https://code.visualstudio.com/docs/agents/reference/mcp-configuration","file":"~/.copilot/mcp-config.json","signIn":"Merge into your native Copilot mcp-config.json. In a Copilot session, authenticate tldw when prompted. MCP: Add Server → Copilot Global offers guided setup.","code":"{\n  \"mcpServers\": {\n    \"tldw\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.tldw.sh/mcp\",\n      \"tools\": [\n        \"*\"\n      ]\n    }\n  }\n}","title":"VS Code / Copilot · sign in with OAuth","description":"Merge into your native Copilot mcp-config.json. In a Copilot session, authenticate tldw when prompted. MCP: Add Server → Copilot Global offers guided setup."},"api_key_alternative":{"id":"vscode","label":"VS Code / Copilot","source":"https://code.visualstudio.com/docs/agents/reference/mcp-configuration","file":"~/.copilot/mcp-config.json","signIn":"Merge into your native Copilot mcp-config.json. In a Copilot session, authenticate tldw when prompted. MCP: Add Server → Copilot Global offers guided setup.","code":"{\n  \"mcpServers\": {\n    \"tldw\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.tldw.sh/mcp\",\n      \"tools\": [\n        \"*\"\n      ],\n      \"headers\": {\n        \"Authorization\": \"Bearer ${TLDW_API_TOKEN}\"\n      }\n    }\n  }\n}","title":"VS Code / Copilot · API-key alternative","description":"Use ~/.copilot/mcp-config.json with TLDW_API_TOKEN supplied privately by the client environment. Preserve existing servers. Keep the key out of this snippet and conversations."},"plugin":null},{"id":"grok","name":"Grok Build","configuration_file":"~/.grok/config.toml","documentation_url":"https://docs.x.ai/build/features/mcp-servers","oauth":{"id":"grok","label":"Grok Build","source":"https://docs.x.ai/build/features/mcp-servers","file":"~/.grok/config.toml","signIn":"Open /mcps and authenticate tldw. This connects Grok Build, separate from Grok web chat.","code":"grok mcp add --transport http tldw 'https://api.tldw.sh/mcp'","title":"Grok Build · sign in with OAuth","description":"Open /mcps and authenticate tldw. This connects Grok Build, separate from Grok web chat."},"api_key_alternative":{"id":"grok","label":"Grok Build","source":"https://docs.x.ai/build/features/mcp-servers","file":"~/.grok/config.toml","signIn":"Open /mcps and authenticate tldw. This connects Grok Build, separate from Grok web chat.","code":"[mcp_servers.tldw]\nurl = \"https://api.tldw.sh/mcp\"\nheaders = { Authorization = \"Bearer ${TLDW_API_TOKEN}\" }","title":"Grok Build · API-key alternative","description":"Use ~/.grok/config.toml with TLDW_API_TOKEN supplied privately by the client environment. Preserve existing servers. Keep the key out of this snippet and conversations."},"plugin":{"repository":"https://github.com/tldwdotsh/tldw-agent-plugin","command":"grok plugin install tldwdotsh/tldw-agent-plugin"}}],"docs_index":"https://tldw.sh/llms.txt","openapi_url":"https://tldw.sh/openapi.json","pricing_url":"https://tldw.sh/pricing.md","errors_url":"https://tldw.sh/docs/errors.json","workflows_url":"https://tldw.sh/agents/workflows.json","packages":{"npm":"@tldw/client","pypi":"tldw-client","registry_published":true,"registry_versions":{"python":"0.2.13","javascript":"0.2.13"},"download_version":"0.2.13","install":{"python":"python -m pip install tldw-client==0.2.13","javascript":"npm install @tldw/client@0.2.13"}},"downloads":{"skill":"https://api.tldw.sh/v1/public/downloads/tldw-skill-0.3.4.zip","skillRelease":"https://tldw.sh/downloads/skill-release.json","javascript":"https://api.tldw.sh/v1/public/downloads/tldw-client-0.2.13.tgz","python":"https://api.tldw.sh/v1/public/downloads/tldw_client-0.2.13-py3-none-any.whl","workflows":"https://api.tldw.sh/v1/public/downloads/tldw-reference-workflows-0.2.15.zip","plugin":"https://api.tldw.sh/v1/public/downloads/tldw-agent-plugin-0.9.4.zip","release":"https://tldw.sh/downloads/agent-release.json"},"workflow":{"submit":"POST /v1/analyses","accepted_status":202,"status":"GET /v1/jobs/{job_id}","result":"GET /v1/summaries/{summary_id}","transcript":"GET /v1/summaries/{summary_id}/transcript","transcript_page":"GET /v1/summaries/{summary_id}/transcript/page","saved_transcript_page":"GET /v1/transcripts/{transcript_id}/page","transcript_representation":"normalized_saved_source_text_and_timestamps","sdk_extract_flow":"analysis_then_wait_then_saved_source_read","terminal_statuses":["completed","failed","canceled"],"waiting_statuses":["queued_for_slot"],"idempotency_header":"Idempotency-Key"},"search":{"endpoint":"POST /v1/searches","mcp_tool":"search_videos","scope":"jobs:write","searches":"x_posts_with_video","youtube_search":"agent_side","max_results":20,"next_page":false,"sorts":["top","latest"],"same_query_replay_minutes":15,"enabled":"GET /v1/public/config features.x_search","allowance":"GET /v1/me plan.monthly_searches","quota_error":"SEARCH_QUOTA_EXCEEDED","next_step":"analyze_media with a result url"},"billing":{"plans":["free","hobby"],"retained_plans":["pro"],"credit_unit":"processing_credit","included_credit_reset":"monthly","included_credit_rollover":false,"default_transcription":"auto","default_fresh_audio":false,"ignored_request_fields":["transcription","force_asr"],"captions_unavailable_error":"CAPTIONS_UNAVAILABLE","credit_rates_per_minute":{"standard":1},"spending_ceiling_parameter":"max_credits","automatic_credit_purchase":false,"agents_can_buy_credits":false,"trial_policy_url":"https://api.tldw.sh/v1/public/security"}}