Use YouTube Data MCP

Workflow

1. Confirm Node.js is installed and

   npm

   and

   npx

   work.
2. Ask user for API key only when missing.
3. Detect client and OS, then write MCP config.
4. Verify MCP connectivity and run capability discovery:

   • tools/list

   • get_patch_notes

5. Strongly recommend helper skill and Python dependency setup for users who want the full local document and spreadsheet workflow.
6. Explain to user how to use current MCP abilities in plain language.

Step 1: Confirm Node.js Tooling

• Assume this skill has already been installed with

  npx skills add ...

  . Do not try to self-update or reinstall this skill unless the user explicitly asks.
• First check the latest stable Node.js release using an official Node.js source when internet access is available.
• Then verify local tooling:

node -v
npm -v
npx -v

• If

  node

  is missing, the agent should install Node.js directly instead of asking the user to do it manually.
• If installation requires elevated permissions, the agent should request permission and then perform the installation itself once permission is granted.
• If

  node

  exists but

  npm

  or

  npx

  fails, treat the local Node.js installation as incomplete and have the agent repair or reinstall Node.js directly instead of sending the user away to do it.
• After Node.js is confirmed, continue with MCP setup. Do not block on Python here.

Step 2: Ask For API Key

• If API key is not already provided in env or config, ask user once:

  • Please provide your MCP API key for https://mkterswingman.com

• Never echo full key in logs; mask with prefix/suffix in outputs.

Step 3: Configure MCP Client

• Read references/client-configs.md.
• Detect environment and patch the matching MCP config file.
• Register this server using:
  • URL:

    https://mkterswingman.com/mcp

  • Header:

    Authorization: Bearer <API_KEY>

  • Transport: Streamable HTTP (or tool-specific equivalent)

Step 4: Post-Install Capability Discovery

• Immediately call:

  • tools/list

  • get_patch_notes

• Summarize:
  • Newest features and limits
  • Which tools support batch input
  • Recommended usage patterns for the current release

Step 5: Strongly Recommended Local File Workflow Setup

• For most users, strongly recommend this step after MCP setup succeeds. It enables the full local document and spreadsheet workflow around the MCP.
• Install optional helper skills with public GitHub URLs:

npx -y skills add https://github.com/anthropics/skills/tree/main/skills/docx --yes
npx -y skills add https://github.com/anthropics/skills/tree/main/skills/xlsx --yes
npx -y skills add https://github.com/anthropics/skills/tree/main/skills/pptx --yes

• If the active agent requires explicit targets, add the same

  --agent ... --global

  options the user used for the main skill install.
• Explain that helper skill installation is separate from MCP setup. The YouTube Data MCP is already usable even before these helpers are installed, but most users will benefit from adding them.
• For Python-backed spreadsheet workflows, assume Python may be missing and verify the interpreter first:

python3 --version

• If

  python3

  is unavailable, also check:

python --version

• If neither

  python3

  nor

  python

  is available, ask the agent to search for the latest official Python installation method for the user's current OS before giving instructions.
• If Python is available but the spreadsheet stack is missing, ask the agent to search for the latest recommended install method for

  pandas

  and

  openpyxl

  on the user's current platform before giving instructions.

Step 6: User Briefing Template

• Tell user:
  • Besides subtitle fetching, most tools support batch inputs.
  • User can paste multiple links directly in chat.
  • User can also provide Excel, CSV, and DOCX for link extraction after the strongly recommended helper setup.
  • Results can be written back to local DOCX or Excel after the strongly recommended helper setup.

Notes

• Keep subtitle mode as single-video per request unless project rules change.
• If a client config path is uncertain, scan candidate config files and pick the one that already contains MCP settings first.
• After changing client config, remind user to restart the client if required.
• Do not assume Codex-specific directories exist. Use agent-neutral commands unless the user explicitly states a client-specific path.