get_creators
Search and browse Civitai's model creators by username, with options to filter results by page number and limit output to streamline discovery of AI model creators.
Instructions
Browse and search for model creators on Civitai
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of creators to return (0-200, default 20) | |
| page | No | Page number for pagination | |
| query | No | Search query to filter creators by username |
Implementation Reference
- src/index.ts:522-538 (handler)The primary handler function for the 'get_creators' MCP tool. It invokes the CivitaiClient's getCreators method, formats the response data into a readable text summary, and returns it in the MCP content format.
private async getCreators(args: any) { const response = await this.client.getCreators(args); return { content: [ { type: 'text', text: `Found ${response.metadata.totalItems || response.items.length} creators:\\n\\n${response.items.map(creator => `**${creator.username}**\\n` + `Models: ${creator.modelCount || 0}\\n` + (creator.link ? `Profile: ${creator.link}\\n` : '') + '\\n' ).join('---\\n')}\\nPage ${response.metadata.currentPage || 1} of ${response.metadata.totalPages || 1}`, }, ], }; } - src/index.ts:194-205 (registration)Registration of the 'get_creators' tool in the MCP server's tool list, including name, description, and input schema definition.
{ name: 'get_creators', description: 'Browse and search for model creators on Civitai', inputSchema: { type: 'object', properties: { limit: { type: 'number', description: 'Number of creators to return (0-200, default 20)', minimum: 0, maximum: 200 }, page: { type: 'number', description: 'Page number for pagination', minimum: 1 }, query: { type: 'string', description: 'Search query to filter creators by username' }, }, }, }, - src/types.ts:133-136 (schema)Zod schema for validating the CreatorsResponse from the Civitai API, used in the client implementation.
export const CreatorsResponseSchema = z.object({ items: z.array(CreatorSchema), metadata: MetadataSchema, }); - src/civitai-client.ts:144-147 (helper)Core API client method that performs the HTTP request to Civitai's /creators endpoint, builds the URL with parameters, and validates the response using the schema.
async getCreators(params: CreatorsParams = {}): Promise<CreatorsResponse> { const url = this.buildUrl('/creators', params); return this.makeRequest<CreatorsResponse>(url, CreatorsResponseSchema); } - src/civitai-client.ts:57-61 (schema)TypeScript interface defining the input parameters for the getCreators method, matching the tool's inputSchema.
export interface CreatorsParams { limit?: number; page?: number; query?: string; } - src/types.ts:48-53 (schema)Zod schema for individual Creator objects returned in the response.
export const CreatorSchema = z.object({ username: z.string(), image: z.string().nullable().optional(), modelCount: z.number().optional(), link: z.string().optional(), });