Marvel MCP

Instructions

Implementation Reference

• src/tools/get_characters_for_comic/index.ts:9-13 (handler)

  The handler function that parses input arguments using the schema, makes an HTTP request to the Marvel API endpoint for characters in a specific comic, and parses the response using CharacterDataWrapperSchema.

  handler: async (args: any) => {
      const { comicId, ...rest } = GetComicCharactersSchema.parse(args);
      const res = await httpRequest(`/comics/${comicId}/characters`, serializeQueryParams(rest));
      return CharacterDataWrapperSchema.parse(res);
  }

• src/tools/get_characters_for_comic/schemas.ts:5-15 (schema)

  Zod schema defining the input parameters for the get_characters_for_comic tool, extending GetComicByIdSchema with additional optional filters for characters.

  export const GetComicCharactersSchema = GetComicByIdSchema.extend({
    name: z.string().optional(),
    nameStartsWith: z.string().optional(),
    modifiedSince: 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(),
  });

• src/tools/get_characters_for_comic/index.ts:6-14 (registration)

  Exports the tool definition object including description, input schema, and handler function, likely used for MCP tool registration.

  export const get_characters_for_comic = {
      description: `Fetch Marvel characters for a given comic.`,
      schema: GetComicCharactersSchema,
      handler: async (args: any) => {
          const { comicId, ...rest } = GetComicCharactersSchema.parse(args);
          const res = await httpRequest(`/comics/${comicId}/characters`, serializeQueryParams(rest));
          return CharacterDataWrapperSchema.parse(res);
      }
  };