Twitter MCP Server

Instructions

Implementation Reference

• src/handlers/user.handlers.ts:86-110 (handler)

  Core handler function that executes the unfollowUser tool: resolves current user ID, looks up target user by username, calls Twitter API v2.unfollow, returns success/error response.

  export const handleUnfollowUser: TwitterHandler<UserHandlerArgs> = async (
      client: TwitterClient | null,
      { username }: UserHandlerArgs
  ): Promise<HandlerResponse> => {
      if (!client) {
          return createMissingTwitterApiKeyResponse('unfollowUser');
      }
  
      try {
          const userId = await client.v2.me().then((response: any) => response.data.id);
          const targetUser = await client.v2.userByUsername(username);
          
          if (!targetUser.data) {
              throw new Error(`User not found: ${username}`);
          }
          
          await client.v2.unfollow(userId, targetUser.data.id);
          return createResponse(`Successfully unfollowed user: ${username}`);
      } catch (error) {
          if (error instanceof Error) {
              throw new Error(formatTwitterError(error, 'unfollowing user'));
          }
          throw error;
      }
  };

• src/types.ts:73-75 (schema)

  TypeScript interface defining input arguments for unfollowUser: requires 'username' string.

  export interface UnfollowUserArgs {
      username: string;
  }

• src/tools.ts:263-272 (schema)

  MCP tool input schema definition: JSON schema object specifying required 'username' parameter for the unfollowUser tool.

  unfollowUser: {
      description: 'Unfollow a user by their username',
      inputSchema: {
          type: 'object',
          properties: {
              username: { type: 'string', description: 'The username of the user to unfollow' }
          },
          required: ['username'],
      },
  },

• src/index.ts:265-268 (registration)

  Tool dispatch registration in main MCP server: switch case that extracts arguments and calls the handleUnfollowUser function.

  case 'unfollowUser': {
      const { username } = request.params.arguments as { username: string };
      response = await handleUnfollowUser(client, { username });
      break;

• src/types.ts:343-350 (helper)

  Runtime argument validator: Type guard function that asserts and validates input conforms to UnfollowUserArgs interface.

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