SociaVault MCP Server

Instructions

Implementation Reference

• src/index.ts:424-443 (handler)

  Handler for the get_tiktok_videos tool: fetches videos from Sociavault API endpoint `/tiktok/videos` using the provided handle, extracts data with `extractTikTokVideos`, and returns JSON-formatted response.

  if (name === "get_tiktok_videos") {
    const { handle } = args as { handle: string };
    const response = await axios.get(`${BASE_URL}/tiktok/videos`, {
      headers: { "X-API-Key": API_KEY },
      params: { handle },
    });
    const extracted = extractTikTokVideos(response.data, 10);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            { handle, videos: extracted, total_returned: extracted.length },
            null,
            2
          ),
        },
      ],
    };
  }

• src/index.ts:267-277 (registration)

  Tool registration entry for get_tiktok_videos, including name, description, and input schema requiring a 'handle' parameter.

  {
    name: "get_tiktok_videos",
    description: "Get TikTok videos from a user",
    inputSchema: {
      type: "object",
      properties: {
        handle: { type: "string", description: "TikTok username" },
      },
      required: ["handle"],
    },
  },

• src/index.ts:99-120 (helper)

  Helper function that parses TikTok API response data to extract up to 10 videos, normalizing fields like id, description, stats, and cover image.

  function extractTikTokVideos(data: any, limit = 10) {
    const videos =
      data?.data?.itemList ||
      data?.itemList ||
      data?.data?.videos ||
      data?.videos ||
      [];
    return videos.slice(0, limit).map((video: any) => {
      const stats = video.statistics || video.stats || {};
      return {
        id: video.id || video.aweme_id,
        description: video.desc || video.description || "",
        likes: stats.like_count || stats.digg_count || 0,
        comments: stats.comment_count || 0,
        shares: stats.share_count || 0,
        views: stats.play_count || stats.view_count || 0,
        timestamp: video.create_time || video.timestamp,
        duration: video.duration,
        cover: video.cover || video.video?.cover || video.cover_url,
      };
    });
  }