createList
Create a new Twitter list to organize accounts by topic or interest, specifying name, description, and privacy settings.
Instructions
Create a new Twitter list
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The name of the list | |
| description | No | A description of the list | |
| private | No | Whether the list should be private |
Implementation Reference
- src/handlers/list.handlers.ts:111-130 (handler)Main handler function executing the createList tool logic: checks for Twitter client, calls client.createList, handles success/error responses.
export async function handleCreateList( client: TwitterClient | null, args: CreateListArgs ): Promise<HandlerResponse> { if (!client) { return createMissingTwitterApiKeyResponse('createList'); } try { const list = await client.createList(args.name, args.description, args.isPrivate); if (!list.data) { throw new Error('Failed to create list'); } return createResponse(`Successfully created list: ${list.data.name}`); } catch (error) { if (error instanceof Error) { throw new Error(formatTwitterError(error, 'creating list')); } throw new Error('Failed to create list: Unknown error occurred'); } } - src/tools.ts:321-332 (schema)MCP tool input schema definition for createList, including properties and requirements.
createList: { description: 'Create a new Twitter list', inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'The name of the list' }, description: { type: 'string', description: 'A description of the list' }, private: { type: 'boolean', description: 'Whether the list should be private' } }, required: ['name'], }, }, - src/index.ts:280-287 (registration)Tool registration in MCP CallToolRequestHandler: extracts arguments and invokes handleCreateList.
case 'createList': { const { name, description, isPrivate } = request.params.arguments as { name: string; description?: string; isPrivate?: boolean; }; response = await handleCreateList(client, { name, description, isPrivate }); break; - src/handlers/list.handlers.ts:13-17 (schema)TypeScript interface defining input arguments for createList handler.
export interface CreateListArgs { name: string; description?: string; isPrivate?: boolean; } - src/client/twitter.ts:235-243 (helper)TwitterClient helper method wrapping Twitter API v2 list creation with rate limit retry logic.
async createList(name: string, description: string = '', isPrivate: boolean = false) { return this.withRateLimitRetry('createList', () => this.v2.createList({ name, description, private: isPrivate }) ); }