list_videos
MCP /mcp
List HelloBooks product videos curated on the marketing site (homepage demo + feature walkthroughs) and the official @hellobooksai YouTube channel link. Each video returns title, description, category, watch URL, embed URL and thumbnail. Filter by category (demo / features / overview), featuredOnly, or free-text query. Use this when a user asks for a demo, walkthrough or video. Note: this is the curated set, not a live mirror of every channel upload — the response includes the channel URL for the full catalog.
No account required
Request example
Connect your client to https://agents.hellobooks.ai/mcp, then call:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_videos",
"arguments": {}
}
}
Fill arguments using the input schema below.Complete published contract
{
"inputSchema": {
"type": "object",
"properties": {
"category": {
"type": "string",
"enum": [
"demo",
"features",
"overview"
],
"description": "Filter to one video category (demo, features, overview)."
},
"featuredOnly": {
"type": "boolean",
"description": "If true, only return videos flagged as featured on the marketing site."
},
"query": {
"type": "string",
"minLength": 2,
"maxLength": 120,
"description": "Optional substring match against video title + description."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"call": {
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_videos",
"arguments": {}
}
}
}