Twitter MCP Server

Instructions

Implementation Reference

• src/handlers/engagement.handlers.ts:45-63 (handler)

  Core handler function that executes the unlikeTweet tool: checks for Twitter client, retrieves authenticated user ID, calls Twitter API v2.unlike(userId, tweetId), and returns success/error response.

  export const handleUnlikeTweet: TwitterHandler<TweetEngagementArgs> = async (
      client: TwitterClient | null,
      { tweetId }: TweetEngagementArgs
  ): Promise<HandlerResponse> => {
      if (!client) {
          return createMissingTwitterApiKeyResponse('unlikeTweet');
      }
      
      try {
          const userId = await client.v2.me().then((response: any) => response.data.id);
          await client.v2.unlike(userId, tweetId);
          return createResponse(`Successfully unliked tweet: ${tweetId}`);
      } catch (error) {
          if (error instanceof Error) {
              throw new Error(formatTwitterError(error, 'unliking tweet'));
          }
          throw error;
      }
  };

• src/tools.ts:45-54 (schema)

  MCP tool registration with input schema definition for unlikeTweet: requires tweetId string.

  unlikeTweet: {
      description: 'Unlike a previously liked tweet',
      inputSchema: {
          type: 'object',
          properties: {
              tweetId: { type: 'string', description: 'The ID of the tweet to unlike' }
          },
          required: ['tweetId'],
      },
  },

• src/types.ts:45-47 (schema)

  TypeScript interface defining input arguments for unlikeTweet handler.

  export interface UnlikeTweetArgs {
      tweetId: string;
  }

• src/index.ts:187-190 (registration)

  MCP server dispatch/registration: routes 'unlikeTweet' tool calls to the handleUnlikeTweet function.

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

• src/types.ts:257-264 (helper)

  Runtime validation function to assert and validate UnlikeTweetArgs input.

  export function assertUnlikeTweetArgs(args: unknown): asserts args is UnlikeTweetArgs {
      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');
      }
  }