Servers Playground How we check Add a server Log in

YouTube data for agents

Working · 1.9 s

sh.fetcher.youtube/mcpv1.0.0 Domain verified

15 YouTube endpoints. Pay per call in USDC via x402.

Marketing & SEO

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://youtube.fetcher.sh/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_balance

Free. Show the remaining credit balance for the API key sent in this connection's Authorization header. Call this before a long run of paid requests.

This tool takes no arguments.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

YouTube data for agents MCP server | mcptry

Tools (17)

check_balance

Free. Show the remaining credit balance for the API key sent in this connection's Authorization header. Call this before a long run of paid requests.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

topup_credits

Paid (the amount you choose, minimum $1). Buy prepaid credits with x402 so later calls skip the per-call payment round trip. With an Authorization: Bearer bby_live_... header on this connection it recharges that key. Without one, the paying wallet becomes the account and a new API key is minted and returned once — store it as a secret, it cannot be recovered.

Argument	Type	Description
amount*	number	Amount to add, in USD. Minimum 1.
rotate	boolean	Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "minimum": 1,
      "description": "Amount to add, in USD. Minimum 1."
    },
    "rotate": {
      "type": "boolean",
      "description": "Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent."
    }
  },
  "additionalProperties": false
}

youtube_channel

Paid ($0.005). Channel — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
id*	string	Required. Path parameter.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    }
  },
  "additionalProperties": false
}

youtube_channel_handle

Paid ($0.005). Channel handle — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
handle*	string	Required. Path parameter.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "handle"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    }
  },
  "additionalProperties": false
}

youtube_channel_live_streams

Paid ($0.005). Channel live streams — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
id*	string	Required. Path parameter.
cursor	string	Optional.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    }
  },
  "additionalProperties": false
}

youtube_channel_path

Paid ($0.005). Channel path — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
channelPath*	string	Required.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "channelPath"
  ],
  "properties": {
    "channelPath": {
      "type": "string",
      "description": "Required."
    }
  },
  "additionalProperties": false
}

youtube_channel_shorts

Paid ($0.005). Channel shorts — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
id*	string	Required. Path parameter.
cursor	string	Optional.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    }
  },
  "additionalProperties": false
}

youtube_channel_videos

Paid ($0.005). Channel videos — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
id*	string	Required. Path parameter.
cursor	string	Optional.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    }
  },
  "additionalProperties": false
}

youtube_hashtag

Paid ($0.005). Hashtag — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
tag*	string	Required. Path parameter.
cursor	string	Optional.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "tag"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    }
  },
  "additionalProperties": false
}

youtube_playlist_videos

Paid ($0.005). Playlist videos — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
id*	string	Required. Path parameter.
cursor	string	Optional.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    }
  },
  "additionalProperties": false
}

youtube_search_channel

Paid ($0.005). Search channel — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
geo	string	Optional.
lang	string	Optional.
query*	string	Required.
cursor	string	Optional.
sortBy	string	Optional. One of: relevance, rating, upload_date, view_count.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "geo": {
      "type": "string",
      "description": "Optional."
    },
    "lang": {
      "type": "string",
      "description": "Optional."
    },
    "query": {
      "type": "string",
      "description": "Required."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    },
    "sortBy": {
      "enum": [
        "relevance",
        "rating",
        "upload_date",
        "view_count"
      ],
      "type": "string",
      "description": "Optional. One of: relevance, rating, upload_date, view_count."
    }
  },
  "additionalProperties": false
}

youtube_search_playlist

Paid ($0.005). Search playlist — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
geo	string	Optional.
lang	string	Optional.
query*	string	Required.
cursor	string	Optional.
sortBy	string	Optional. One of: relevance, rating, upload_date, view_count.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "geo": {
      "type": "string",
      "description": "Optional."
    },
    "lang": {
      "type": "string",
      "description": "Optional."
    },
    "query": {
      "type": "string",
      "description": "Required."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    },
    "sortBy": {
      "enum": [
        "relevance",
        "rating",
        "upload_date",
        "view_count"
      ],
      "type": "string",
      "description": "Optional. One of: relevance, rating, upload_date, view_count."
    }
  },
  "additionalProperties": false
}

youtube_search_video

Paid ($0.005). Search video — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
geo	string	Optional.
lang	string	Optional.
query*	string	Required.
cursor	string	Optional.
sortBy	string	Optional. One of: relevance, rating, upload_date, view_count.
duration	string	Optional. One of: short, medium, long.
features	string	Optional. One of: hd, subtitles, creative_commons, 3d, live, purchased, 4k, 360, location, hdr, vr180.
uploadDate	string	Optional. One of: hour, today, week, month, year.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "geo": {
      "type": "string",
      "description": "Optional."
    },
    "lang": {
      "type": "string",
      "description": "Optional."
    },
    "query": {
      "type": "string",
      "description": "Required."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    },
    "sortBy": {
      "enum": [
        "relevance",
        "rating",
        "upload_date",
        "view_count"
      ],
      "type": "string",
      "description": "Optional. One of: relevance, rating, upload_date, view_count."
    },
    "duration": {
      "enum": [
        "short",
        "medium",
        "long"
      ],
      "type": "string",
      "description": "Optional. One of: short, medium, long."
    },
    "features": {
      "enum": [
        "hd",
        "subtitles",
        "creative_commons",
        "3d",
        "live",
        "purchased",
        "4k",
        "360",
        "location",
        "hdr",
        "vr180"
      ],
      "type": "string",
      "description": "Optional. One of: hd, subtitles, creative_commons, 3d, live, purchased, 4k, 360, location, hdr, vr180."
    },
    "uploadDate": {
      "enum": [
        "hour",
        "today",
        "week",
        "month",
        "year"
      ],
      "type": "string",
      "description": "Optional. One of: hour, today, week, month, year."
    }
  },
  "additionalProperties": false
}

youtube_shorts

Paid ($0.005). Shorts — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
id*	string	Required. Path parameter.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    }
  },
  "additionalProperties": false
}

youtube_trending

Paid ($0.005). Trending — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
geo	string	Optional.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "geo": {
      "type": "string",
      "description": "Optional."
    }
  },
  "additionalProperties": false
}

youtube_video

Paid ($0.005). Video — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
id*	string	Required. Path parameter.
type	string	Optional. One of: video, shorts.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    },
    "type": {
      "enum": [
        "video",
        "shorts"
      ],
      "type": "string",
      "description": "Optional. One of: video, shorts."
    }
  },
  "additionalProperties": false
}

youtube_video_comments

Paid ($0.005). Video comments — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Argument	Type	Description
id*	string	Required. Path parameter.
sort	string	Optional. One of: top, latest.
cursor	string	Optional.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Required. Path parameter."
    },
    "sort": {
      "enum": [
        "top",
        "latest"
      ],
      "type": "string",
      "description": "Optional. One of: top, latest."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    }
  },
  "additionalProperties": false
}