X MCP Server

Instructions

Implementation Reference

• src/index.ts:232-263 (handler)

  The handler function that performs the tweet search using TwitterApi v2.search, validates input, formats results, and returns them.

  private async searchTweets(args: any) {
    if (!this.twitterClient) {
      throw new Error("Twitter client not initialized");
    }
  
    const { query, count = 10 } = args;
  
    if (!query || typeof query !== "string") {
      throw new Error("Query is required and must be a string");
    }
  
    const searchCount = Math.min(count, 100);
  
    const tweets = await this.twitterClient.v2.search(query, {
      max_results: searchCount,
      "tweet.fields": ["created_at", "author_id"],
    });
  
    const tweetList = tweets.data.data || [];
    const formattedTweets = tweetList
      .map((tweet) => `- ${tweet.text} (by @${tweet.author_id})`)
      .join("\n");
  
    return {
      content: [
        {
          type: "text",
          text: `Search results for "${query}":\n${formattedTweets}`,
        },
      ],
    };
  }

• src/index.ts:67-81 (schema)

  Input schema definition for the search_tweets tool, specifying query and optional count parameters.

  inputSchema: {
    type: "object",
    properties: {
      query: {
        type: "string",
        description: "Search query for tweets",
      },
      count: {
        type: "number",
        description: "Number of tweets to retrieve (max 100)",
        default: 10,
      },
    },
    required: ["query"],
  },

• src/index.ts:64-82 (registration)

  Tool registration in getTools() method, defining name, description, and input schema for listTools response.

  {
    name: "search_tweets",
    description: "Search for tweets using a query",
    inputSchema: {
      type: "object",
      properties: {
        query: {
          type: "string",
          description: "Search query for tweets",
        },
        count: {
          type: "number",
          description: "Number of tweets to retrieve (max 100)",
          default: 10,
        },
      },
      required: ["query"],
    },
  },

• src/index.ts:113-114 (registration)

  Dispatch case in the CallToolRequest handler that routes to the searchTweets method.

  case "search_tweets":
    return await this.searchTweets(args);