get_characters
Retrieve Marvel character data with customizable filters such as name, comics, events, and series to streamline your API queries and data extraction.
Instructions
Fetch Marvel characters with optional filters
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| comics | No | ||
| events | No | ||
| limit | No | ||
| modifiedSince | No | ||
| name | No | ||
| nameStartsWith | No | ||
| offset | No | ||
| orderBy | No | ||
| series | No | ||
| stories | No |
Implementation Reference
- src/tools/get_characters/index.ts:6-14 (registration)Tool registration and handler: defines the get_characters tool with description, input schema, and async handler that validates args, serializes query params, fetches from Marvel API /characters endpoint, and parses response using CharacterDataWrapperSchema.
export const get_characters = { description: `Fetch Marvel characters with optional filters.`, schema: GetCharactersSchema, handler: async (args: any) => { const argsParsed = GetCharactersSchema.parse(args); const res = await httpRequest('/characters', serializeQueryParams(argsParsed)); return CharacterDataWrapperSchema.parse(res); } }; - Input schema (Zod) for get_characters tool, defining optional filters like name, limit, offset, etc., matching Marvel API character list parameters.
export const GetCharactersSchema = z.object({ name: z.string().optional(), nameStartsWith: z.string().optional(), modifiedSince: z.string().optional(), comics: z.string().optional(), series: z.string().optional(), events: z.string().optional(), stories: z.string().optional(), orderBy: z.string().optional(), limit: z.number().min(1).max(100).optional(), offset: z.number().optional(), });