@brave/brave-search-mcp-server/dist/tools/videos/index.js

Brave Search MCP Server: web results, images, videos, rich results, AI summaries, and more.

import params from './params.js';
import API from '../../BraveAPI/index.js';
import { stringify } from '../../utils.js';
export const name = 'brave_video_search';
export const annotations = {
    title: 'Brave Video Search',
    openWorldHint: true,
};
export const description = `
    Searches for videos using Brave's Video Search API and returns structured video results with metadata.

    When to use:
        - When you need to find videos related to a specific topic, keyword, or query.
        - Useful for discovering video content, getting video metadata, or finding videos from specific creators/publishers.

    Returns a JSON list of video-related results with title, url, description, duration, and thumbnail_url.
`.trim();
export const execute = async (params) => {
    const response = await API.issueRequest('videos', params);
    return {
        content: response.results.map(({ url, title, description, video, thumbnail }) => {
            const duration = video?.duration;
            const thumbnail_url = thumbnail?.src;
            return {
                type: 'text',
                text: stringify({ url, title, description, duration, thumbnail_url }),
            };
        }),
    };
};
export const register = (mcpServer) => {
    mcpServer.registerTool(name, {
        title: name,
        description: description,
        inputSchema: params.shape,
        annotations: annotations,
    }, execute);
};
export default {
    name,
    description,
    annotations,
    inputSchema: params.shape,
    execute,
    register,
};