X Tools for Claude MCP

Implementation Reference

• tools/twitter.js:79-101 (handler)

  The registered tool handler that performs the search using helper functions and returns formatted results or error message.
  async ({ query, section, limit }) => { try { // Use the search function with the query directly const tweets = await performTwitterSearch(query, section, limit); // Format the response return { content: [{ type: "text", text: formatTwitterResults(query, tweets, section) }] }; } catch (error) { console.error('Error searching Twitter:', error); return { content: [{ type: "text", text: `Error searching Twitter: ${error.message}` }] }; } } );
• tools/twitter.js:75-78 (schema)

  Zod input schema for the searchTwitter tool defining query, section, and limit parameters.
  query: z.string().min(1, "Search query is required"), section: z.enum(["latest", "top"]).optional().default("latest"), limit: z.number().int().positive().optional().default(20) },
• tools/twitter.js:73-102 (registration)

  Registration of the searchTwitter tool using server.tool() with schema and handler.
  server.tool("searchTwitter", { query: z.string().min(1, "Search query is required"), section: z.enum(["latest", "top"]).optional().default("latest"), limit: z.number().int().positive().optional().default(20) }, async ({ query, section, limit }) => { try { // Use the search function with the query directly const tweets = await performTwitterSearch(query, section, limit); // Format the response return { content: [{ type: "text", text: formatTwitterResults(query, tweets, section) }] }; } catch (error) { console.error('Error searching Twitter:', error); return { content: [{ type: "text", text: `Error searching Twitter: ${error.message}` }] }; } } ); }
• tools/twitter.js:14-70 (helper)

  Helper function performing paginated Twitter searches using RapidAPI.
  const performTwitterSearch = async (query, section, limit) => { // Check for API key if (!RAPIDAPI_KEY) { throw new Error("RAPIDAPI_KEY environment variable is not set"); } // Log the query for debugging console.error(`TWITTER SEARCH: ${query}`); // Track all fetched tweets let allTweets = []; let continuationToken = null; // RapidAPI has a max of 20 per request, so we'll need to paginate const maxPerRequest = 20; const requestsNeeded = Math.ceil(limit / maxPerRequest); // Make requests until we hit the limit or run out of results for (let i = 0; i < requestsNeeded; i++) { // Build the query parameters const params = new URLSearchParams({ query: query, section: section, limit: Math.min(maxPerRequest, limit - allTweets.length).toString() }); // Add continuation token if available if (continuationToken) { params.append('continuation_token', continuationToken); } // Make the API request const response = await axios({ method: 'GET', url: `https://twitter154.p.rapidapi.com/search/search?${params.toString()}`, headers: { 'x-rapidapi-key': RAPIDAPI_KEY, 'x-rapidapi-host': RAPIDAPI_HOST } }); // Extract tweets and continuation token const newTweets = response.data.results || []; allTweets = [...allTweets, ...newTweets]; // Store continuation token for next request continuationToken = response.data.continuation_token; // Stop if we don't have a continuation token or reached our limit if (!continuationToken || allTweets.length >= limit) { break; } } // Return only up to the requested limit return allTweets.slice(0, limit); };
• tools/twitter.js:111-213 (helper)

  Helper function to format Twitter search results into readable Markdown output.
  function formatTwitterResults(query, tweets, section) { if (!tweets || tweets.length === 0) { return `No tweets found for query: ${query}`; } let output = []; tweets.forEach((tweet, index) => { // Create clear separation between tweets output.push(`## [${index + 1}] Tweet by @${tweet.user.username}`); // User information let userInfo = `**User:** ${tweet.user.name} (@${tweet.user.username})`; if (tweet.user.is_blue_verified) { userInfo += ` [Verified]`; } else if (tweet.user.is_verified) { userInfo += ` [Verified]`; } output.push(userInfo); // User stats if available if (tweet.user) { const userStats = []; if (tweet.user.follower_count !== undefined) userStats.push(`${tweet.user.follower_count} followers`); if (tweet.user.following_count !== undefined) userStats.push(`${tweet.user.following_count} following`); if (userStats.length > 0) { output.push(`**Account stats:** ${userStats.join(', ')}`); } } // Tweet content output.push(`\n**Content:** ${tweet.text}\n`); // Engagement metrics let metrics = []; metrics.push(`${tweet.favorite_count} likes`); metrics.push(`${tweet.retweet_count} retweets`); metrics.push(`${tweet.reply_count} replies`); // Add quotes and bookmarks if available if (tweet.quote_count) metrics.push(`${tweet.quote_count} quotes`); if (tweet.bookmark_count) metrics.push(`${tweet.bookmark_count} bookmarks`); // Add view count if available if (tweet.views) metrics.push(`${tweet.views} views`); output.push(`**Engagement:** ${metrics.join(' | ')}`); // Creation date - fix the Invalid Date issue try { // Try parsing the date properly const date = new Date(tweet.created_at || tweet.creation_date); const formattedDate = !isNaN(date.getTime()) ? `${date.toLocaleDateString('en-GB')} ${date.toLocaleTimeString('en-GB')}` : 'Date unavailable'; output.push(`**Posted:** ${formattedDate}`); } catch (e) { output.push(`**Posted:** Date format error`); } // Add reply info if it's a reply if (tweet.in_reply_to_status_id_str) { output.push(`**Reply to:** https://twitter.com/status/${tweet.in_reply_to_status_id_str}`); } // Add media if available if (tweet.media && tweet.media.length > 0) { output.push(`**Media:** ${tweet.media.length} attachment(s)`); tweet.media.forEach(media => { output.push(` - ${media.media_url_https || media.media_url}`); }); } // Add video info if available if ((tweet.extended_entities && tweet.extended_entities.media && tweet.extended_entities.media.some(m => m.type === "video" || m.type === "animated_gif")) || tweet.video_url) { output.push(`**Video:** ${tweet.video_url || "Multiple formats available"}`); } // Add tweet URL - construct a proper URL const tweetId = tweet.id_str || tweet.tweet_id; if (tweetId && tweet.user && tweet.user.username) { output.push(`**URL:** https://twitter.com/${tweet.user.username}/status/${tweetId}`); } else { output.push(`**URL:** Unable to construct URL (missing id or username)`); } // Add separator between tweets output.push('\n---\n'); }); return output.join('\n'); }