Marvel MCP Server

- List Marvel Characters: Supports filters likenameStartsWith,limit,comics,series, etc.
- Fetch a Marvel Character by ID: Get detailed info on any character using theircharacterId.
- Fetch Comics for a Character: Get a list of comics featuring a specific character, with various filters likeformat,dateRange, etc.
- Rich Content Display: When you ask about characters or comics, the server will:

- Display detailed information about characters and comics including images, names, descriptions, and more.
- Create an HTML page (marvel-content.html) with all the content in it.
- Attempt to open the newly created HTML page in your default browser for an enhanced viewing experience.

- Description: Fetch Marvel characters with optional filters.
- Inputs:

- name(optional string): Full character name.
- nameStartsWith(optional string): Characters whose names start with the specified string.
- modifiedSince(optional string): ISO 8601 date string to filter characters modified since this date.
- comics,series,events,stories(optional string): Comma-separated list of IDs to filter by related entities.
- orderBy(optional string): Fields to order the results by, such asnameor-modified.
- limit(optional number): Maximum number of results to return (1–100).
- offset(optional number): Number of results to skip for pagination.

- Description: Fetch a Marvel character by their unique ID.
- Input:

- characterId(number): The unique ID of the character.

- Description: Fetch comics featuring a specific character, with optional filters.
- Inputs:

- characterId(number): The unique ID of the character.
- Optional filters:

- format,formatType(string): Filter by comic format (e.g.,comic,hardcover).
- noVariants,hasDigitalIssue(boolean): Flags to exclude variants or include only digital issues.
- dateDescriptor(string): Predefined date ranges likethisWeek,nextWeek.
- dateRange(string): Custom date range in the formatYYYY-MM-DD,YYYY-MM-DD.
- title,titleStartsWith(string): Filter by title or title prefix.
- startYear,issueNumber,digitalId(number): Numeric filters.
- diamondCode,upc,isbn,ean,issn(string): Identifier filters.
- creators,series,events,stories,sharedAppearances,collaborators(string): Comma-separated list of related entity IDs.
- orderBy(string): Fields to order the results by, such astitleor-modified.
- limit,offset(number): Pagination options.

- Description: Fetch lists of Marvel comics with optional filters.
- Inputs:

- format(optional string): Filter by the issue format (e.g.,comic,digital comic,hardcover).
- formatType(optional string): Filter by the issue format type (comicorcollection).
- noVariants(optional boolean): Exclude variants (alternate covers, secondary printings, director's cuts, etc.) from the result set.
- dateDescriptor(optional string): Return comics within a predefined date range (lastWeek,thisWeek,nextWeek,thisMonth).
- dateRange(optional string): Return comics within a custom date range. Dates must be specified asYYYY-MM-DD,YYYY-MM-DD.
- title(optional string): Return only issues in series whose title matches the input.
- titleStartsWith(optional string): Return only issues in series whose title starts with the input.
- startYear(optional number): Return only issues in series whose start year matches the input.
- issueNumber(optional number): Return only issues in series whose issue number matches the input.
- diamondCode,digitalId,upc,isbn,ean,issn(optional string): Filter by various identifiers.
- hasDigitalIssue(optional boolean): Include only results which are available digitally.
- modifiedSince(optional string): Return only comics which have been modified since the specified date (ISO 8601 format).
- creators,characters,series,events,stories,sharedAppearances,collaborators(optional string): Comma-separated list of IDs to filter by related entities.
- orderBy(optional string): Order the result set by a field or fields. Add a "-" to the value to sort in descending order (e.g.,title,-modified).
- limit(optional number): Limit the result set to the specified number of resources (default: 20, max: 100).
- offset(optional number): Skip the specified number of resources in the result set.

- Description: Fetch a single Marvel comic by its unique ID.
- Input:

- comicId(number): The unique ID of the comic.

- Description: Fetch Marvel characters appearing in a specific comic.
- Inputs:

- comicId(number): The unique ID of the comic.
- Optional filters:

- name(optional string): Filter characters by full name.
- nameStartsWith(optional string): Filter characters whose names start with the specified string.
- modifiedSince(optional string): ISO 8601 date string to filter characters modified since this date.
- series,events,stories(optional string): Comma-separated list of related entity IDs to filter by.
- orderBy(optional string): Fields to order the results by, such asnameor-modified.
- limit(optional number): Maximum number of results to return (1–100).
- offset(optional number): Number of results to skip for pagination.

Run the Server Locally with MCP Inspector

If you'd like to run MCP Inspector locally to test the server, follow these steps:

git clone https://github.com/DanWahlin/marvel-mcp

Add your Marvel API public and private keys to the.envfile.

MARVEL_PUBLIC_KEY=YOUR_PUBLIC_KEY MARVEL_PRIVATE_KEY=YOUR_PRIVATE_KEY MARVEL_API_BASE=https://gateway.marvel.com/v1/public

Install the required dependencies and build the project.

(Optional) To try out the server using MCP Inspector run the following command:

# Start the MCP Inspector npx @modelcontextprotocol/inspector node dist/index.js

Visit the MCP Inspector URL shown in the console in your browser. ChangeArgumentstodist/index.jsand selectConnect. SelectList Toolsto see the available tools.

Add the following to yourclaude_desktop_config.json:

npx -y @smithery/cli install @DanWahlin/marvel-mcp --client claude

Note: If you already have the MCP server enabled with Claude Desktop, addchat.mcp.discovery.enabled: truein your VS Code settings and it will discover existing MCP server lists.

Add the following to your user settings file or add it to the.vscode/mcp.jsonfile if you only want it available in this repo (you can use MCP: Add Server from the command palette and select Global or Workspace):