get-trending-feed

Implementation Reference

• src/mcp/tools/contentTools.ts:382-431 (registration)

  Registration of the 'get-trending-feed' tool on the MCP server, including input schema (Zod validation) and the inline handler function that executes the tool logic by delegating to the platform provider's getTrendingFeed method and formatting the response.

  // Get trending feed tool
  server.tool(
    "get-trending-feed",
    {
      platform: z.string().describe("Social platform (farcaster, twitter, telegram)"),
      provider: z.enum(['neynar', 'openrank', 'mbd']).optional().describe("Provider to use for trending feed (default: neynar)"),
      timeWindow: z.enum(['1h', '6h', '12h', '24h', '7d', '30d']).optional().describe("Time window for trending content (default: 24h)"),
      limit: z.number().optional().describe("Maximum number of trending items to return (default: 20)")
    },
    async ({ platform, provider, timeWindow, limit = 20 }) => {
      try {
        // Check if platform supports trending feed
        if (platform !== 'farcaster') {
          return {
            content: [{ 
              type: "text", 
              text: `Trending feed with multiple providers is currently only supported for Farcaster. For ${platform}, please use the get-trending-topics tool instead.` 
            }],
            isError: true
          };
        }
  
        const providerInstance = providerRegistry.getProviderForPlatform(platform);
        
        if (!providerInstance) {
          return {
            content: [{ type: "text", text: `Provider for platform '${platform}' not found or not enabled` }],
            isError: true
          };
        }
        
        const feed = await providerInstance.getTrendingFeed({ provider, timeWindow, limit });
        
        return {
          content: [{ 
            type: "text", 
            text: formatTrendingFeed(feed, platform) 
          }]
        };
      } catch (error) {
        return {
          content: [{ 
            type: "text", 
            text: `Error fetching ${platform} trending feed: ${error instanceof Error ? error.message : String(error)}` 
          }],
          isError: true
        };
      }
    }
  );

• src/mcp/tools/contentTools.ts:609-622 (helper)

  Supporting utility function that formats the array of SocialContent from the trending feed into a human-readable markdown-style text response for the tool output.

  function formatTrendingFeed(feed: SocialContent[], platform: string): string {
    if (feed.length === 0) {
      return `No trending content available for ${platform}.`;
    }
    
    const formattedFeed = feed.map((item, index) => {
      return `[${index + 1}] @${item.authorUsername} (${item.authorName}): "${item.text}"
      - Posted: ${new Date(item.createdAt).toLocaleString()}
      - Engagement: ${item.likes || 0} likes, ${item.reposts || 0} reposts, ${item.replies || 0} replies
      - ID: ${item.id}`;
    }).join('\n\n');
    
    return `Trending Feed on ${platform}:\n\n${formattedFeed}`;
  }

• src/mcp/server.ts:24-27 (registration)

  Top-level registration call to registerContentTools, which in turn registers the 'get-trending-feed' tool (and other content tools) on the MCP server instance.

  // Register MCP capabilities
  registerContentResources(server, providerRegistry);
  registerContentTools(server, providerRegistry);
  registerContentPrompts(server);