Marvel

MCP server that exposes Marvel API data and supports character/comic queries and rich content rendering.

typescript

14

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "danwahlin-marvel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@codewithdan/marvel-mcp"
      ],
      "env": {
        "MARVEL_API_BASE": "https://gateway.marvel.com/v1/public",
        "MARVEL_PUBLIC_KEY": "YOUR_PUBLIC_KEY",
        "MARVEL_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      }
    }
  }
}

You can run a self-contained MCP server that exposes Marvel API data to MCP clients. It lets you list characters and comics, fetch details by ID, and generate rich HTML content pages for viewing inside your tooling ecosystem. It’s designed to work with MCP tools and host configuration so you can plug it into Claude Desktop, GitHub Copilot, or other MCP-enabled clients.

How to use

You access the Marvel MCP Server through your MCP client or IDE by pointing it to the local stdio server you run, typically via your package manager. Start by installing and running the server in your development environment. Once running, you can issue tools to list Marvel characters, fetch a character by ID, obtain comics for a character, or retrieve lists of comics. When you request information about a character or a comic, the server will generate a detailed content page named marvel-content.html in your project root and will try to open it in your default browser for easy viewing.

Usage patterns

List Marvel characters with optional filters such as nameStartsWith, comics, series, limit, and offset.
Fetch a character by their ID to get full details including imagery and descriptions.
Retrieve comics featuring a specific character with filters like format, dateRange, title, startYear, and more.
Retrieve a list of comics with optional filters and pagination.

Available tools

get_characters

Fetch Marvel characters with optional filters such as name, nameStartsWith, modifiedSince, related entities (comics, series, events, stories), orderBy, limit, and offset. Returns JSON matching characters.

get_character_by_id

Fetch a Marvel character by their unique ID and return detailed character information.

get_comics_for_character

Fetch comics that feature a specific character with optional filters like format, dateDescriptor, dateRange, title, startYear, orderBy, limit, and offset.

get_comics

Fetch lists of Marvel comics with optional filters such as format, dateDescriptor, dateRange, title, startYear, issueNumber, identifiers, hasDigitalIssue, creators, characters, series, events, and pagination.

get_comic_by_id

Fetch a single Marvel comic by its unique ID and return detailed information.

get_characters_for_comic

Fetch Marvel characters appearing in a specific comic with optional filters for name, nameStartsWith, modifiedSince, related entities, and pagination.