SociaVault MCP Server

Instructions

Implementation Reference

• src/index.ts:355-365 (handler)

  The handler logic within the CallToolRequestSchema request handler that executes the get_instagram_profile tool: makes an API call to Sociavault's Instagram profile endpoint using the provided handle, extracts data with extractInstagramProfile, and returns formatted JSON.

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

• src/index.ts:212-222 (registration)

  Registration of the get_instagram_profile tool in the tools array used by the MCP server's ListToolsRequestSchema handler.

  {
    name: "get_instagram_profile",
    description: "Get Instagram profile data",
    inputSchema: {
      type: "object",
      properties: {
        handle: { type: "string", description: "Instagram username" },
      },
      required: ["handle"],
    },
  },

• src/index.ts:215-221 (schema)

  Input schema definition for the get_instagram_profile tool, specifying a required 'handle' string parameter.

  inputSchema: {
    type: "object",
    properties: {
      handle: { type: "string", description: "Instagram username" },
    },
    required: ["handle"],
  },

• src/index.ts:21-36 (helper)

  Helper function that parses and extracts key Instagram profile fields from the raw API response data.

  function extractInstagramProfile(data: any) {
    const user = data?.data?.user || data?.user || {};
    return {
      username: user.username,
      full_name: user.full_name,
      biography: user.biography,
      followers: user.edge_followed_by?.count || 0,
      following: user.edge_follow?.count || 0,
      posts_count: user.edge_owner_to_timeline_media?.count || 0,
      is_verified: user.is_verified,
      is_private: user.is_private,
      is_business: user.is_business_account,
      external_url: user.external_url,
      profile_pic_url: user.profile_pic_url,
    };
  }