Twitter MCP Server

Instructions

Implementation Reference

• src/handlers/socialdata/search.handlers.ts:93-127 (handler)

  The core handler function that implements the trendingTopicsSearch tool logic by querying recent popular tweets based on location, timeframe, and count parameters.
  export const handleTrendingTopicsSearch: SocialDataHandler<TrendingTopicsArgs> = async ( _client: any, { location = 'worldwide', timeframe = 'hourly', count = 10 }: TrendingTopicsArgs ) => { try { const socialClient = getSocialDataClient(); if (!socialClient) { return createMissingApiKeyResponse('Trending Topics Search'); } // For trending topics, we'll search for popular recent content const query = `filter:popular -filter:replies`; const now = new Date(); const timeOffset = timeframe === 'hourly' ? 1 : timeframe === 'daily' ? 24 : 168; // hours const startTime = new Date(now.getTime() - timeOffset * 60 * 60 * 1000).toISOString(); const result = await socialClient.searchTweets({ query, maxResults: count, startTime, endTime: now.toISOString() }); if (!result.data || result.data.length === 0) { return createSocialDataResponse(`No trending topics found for ${location} (${timeframe})`); } return createSocialDataResponse( formatTweetList(result.data, `Trending Topics - ${location} (${timeframe})`) ); } catch (error) { throw new Error(formatSocialDataError(error as Error, 'trending topics search')); } };
• src/socialdata-tools.ts:76-99 (schema)

  JSON schema definition for the trendingTopicsSearch tool input parameters, used for MCP tool registration.
  trendingTopicsSearch: { description: 'Get trending topics and popular content for analysis', inputSchema: { type: 'object', properties: { location: { type: 'string', description: 'Location for trending topics (default: "worldwide")' }, timeframe: { type: 'string', enum: ['hourly', 'daily', 'weekly'], description: 'Timeframe for trending analysis (default: "hourly")' }, count: { type: 'number', description: 'Number of trending topics to return (default: 10, max: 50)', minimum: 1, maximum: 50 } }, required: [] } },
• src/index.ts:436-439 (registration)

  Registration and dispatch of the trendingTopicsSearch tool in the main CallToolRequestSchema switch statement.
  case 'trendingTopicsSearch': { const args = request.params.arguments as any; response = await handleTrendingTopicsSearch(client, args); break;
• src/types/socialdata.ts:33-37 (schema)

  TypeScript type definition for TrendingTopicsArgs, matching the tool's input schema.
  export interface TrendingTopicsArgs { location?: string; timeframe?: 'hourly' | 'daily' | 'weekly'; count?: number; }