Twitter MCP Server

Instructions

Implementation Reference

• src/handlers/tweet.handlers.ts:62-81 (handler)

  The main handler function that implements the getTweetById tool logic. It uses the TwitterClient to fetch a single tweet by ID via the v2 API, including fields like created_at, public_metrics, and text. Handles missing client and errors appropriately.

  export async function handleGetTweetById(
      client: TwitterClient | null,
      { tweetId }: { tweetId: string }
  ): Promise<HandlerResponse> {
      if (!client) {
          return createMissingTwitterApiKeyResponse('Get Tweet by ID');
      }
  
      try {
          const tweet = await client.v2.singleTweet(tweetId, {
              'tweet.fields': 'created_at,public_metrics,text'
          });
          return createResponse(`Tweet details: ${JSON.stringify(tweet.data, null, 2)}`);
      } catch (error) {
          if (error instanceof Error) {
              throw new Error(formatTwitterError(error, 'getting tweet'));
          }
          throw new Error('Failed to get tweet: Unknown error occurred');
      }
  }

• src/index.ts:167-170 (registration)

  Registration and dispatch point in the MCP server request handler. Matches the tool name and calls the handleGetTweetById function with parsed arguments.

  case 'getTweetById': {
      const { tweetId } = request.params.arguments as { tweetId: string };
      response = await handleGetTweetById(client, { tweetId });
      break;

• src/tools.ts:142-161 (schema)

  Tool schema definition used for listing tools and input validation. Defines the input schema with required tweetId string and optional tweetFields array.

  getTweetById: {
      description: 'Get a tweet by its ID',
      inputSchema: {
          type: 'object',
          properties: {
              tweetId: {
                  type: 'string',
                  description: 'The ID of the tweet'
              },
              tweetFields: {
                  type: 'array',
                  items: {
                      type: 'string'
                  },
                  description: 'Fields to include in the tweet object'
              }
          },
          required: ['tweetId']
      }
  },

• src/types.ts:28-30 (schema)

  TypeScript interface defining the arguments for getTweetById.

  export interface GetTweetByIdArgs {
      tweetId: string;
  }

• src/types.ts:200-207 (schema)

  Runtime assertion function to validate getTweetById arguments.

  export function assertGetTweetByIdArgs(args: unknown): asserts args is GetTweetByIdArgs {
      if (typeof args !== 'object' || args === null) {
          throw new Error('Invalid arguments: expected object');
      }
      if (!('tweetId' in args) || typeof (args as any).tweetId !== 'string') {
          throw new Error('Invalid arguments: expected tweetId string');
      }
  }