https://mcp.poix.io. Every tool is a thin wrapper around the corresponding Poix REST API endpoint, so inputs, outputs, and billing match the API Reference exactly — nothing added, nothing hidden.
Every tool call is billed against your Poix balance the same way a REST API request is. Cost is denominated in quota units for endpoints that mirror the YouTube Data API (see Pricing for the underlying $/unit rate), or a flat credit for endpoints backed by Poix’s media/caption providers.
Search & Discovery
search_videos
Search YouTube for videos, channels, and playlists by keyword, with the full set of YouTube search filters (date range, duration, category, region, language, and more).
Cost: 100 quota units per call (~$0.00203) — the most expensive single tool, matching the YouTube Data API’s own
search.list cost.
search_autocomplete
Get YouTube’s search-suggestion completions for a partial query — useful for query refinement before a full search_videos call.
Cost: 1 quota unit per call (~$0.00013).
get_related_videos
Get videos related to a given video, ranked by the provider. The source video is never returned, and duplicates across pages are removed. Mirrors GET /relatedVideos.
Cost: No YouTube Data API quota units — this tool is served by Poix’s related-videos provider. Billed at ~0.0005 per additional page to ~$0.00503 for ten. Only pages actually fetched are charged; the
pagesFetched field in the response reports how many that was.
Details
get_video_details
Get full metadata for up to 50 videos by ID: title, description, stats, tags, category, duration, and more.
Cost: 1 quota unit per call (~$0.00013), regardless of how many IDs are batched in.
get_popular_videos
Get the current popular/trending videos list, filterable by region and category.
Cost: 1 quota unit per call (~$0.00013).
get_channel_details
Get full metadata for one or more channels, looked up by ID, handle, or legacy username.
Cost: 1 quota unit per call (~$0.00013).
Playlists & Comments
get_playlist_items
Get the items in a playlist, or a channel’s uploads, or look up specific playlist-item IDs.
Cost: 1 quota unit per call (~$0.00013).
get_comments
Get top-level comment threads for a video or channel, or look up specific comment IDs, with sorting and text search.
Cost: 1 quota unit per call (~$0.00013).
get_comment_replies
Get replies to a specific top-level comment.
Cost: 1 quota unit per call (~$0.00013).
Media & Captions
get_video_files
Get direct, time-limited URLs for a video’s underlying video/audio media formats and their metadata (resolution, bitrate, size, container).
Cost: flat credit per call (~$0.00053), matching the
GET /files/video/{videoId} rate.
get_video_captions
Get a video’s captions/transcript as structured JSON (with per-line timing and speech rate) or as plain text.
The
mode parameter controls what happens when native captions aren’t available in the requested language: default errors out, fallback-auto-translated uses YouTube’s auto-translated captions, fallback-whisper transcribes with Whisper only if no captions exist at all, and force-whisper always transcribes with Whisper.
Cost: flat credit per call (~$0.00053) for native/auto-translated captions, matching GET /captions/{videoId}. Whisper-fallback modes (fallback-whisper, force-whisper) cost more, billed by audio duration/GPU time — avoid force-whisper unless you specifically need it.