# Marvel Comics MCP > Marvel Comics MCP Server lets your agent query every detail of the Marvel universe using natural language. You can search characters, find comics by issue number or character, track down story events like Civil War, and map out creator credits. It's a full metadata archive for collectors, writers, and fans. ## Overview - **Category:** content-management - **Price:** Free - **Tags:** comics, character-metadata, pop-culture, media-assets, entertainment-data, api-integration ## Description Listen up. This **Marvel Comics MCP Server** lets your agent drill down into the whole Marvel universe metadata. Forget flipping through dusty wikis or juggling half a dozen databases; you just ask what you need, and it pulls accurate data straight out of the system. It's basically a full-stack archive for anyone writing comics, collecting 'em, or just geekin' out. Here’s what your agent can handle: **Character Profiles:** You can get a character's whole bio, image link, and a list of every single comic series they showed up in using the `get_character` tool. If you don't know who you're talking about, start by running `list_characters` to search for IDs and names first. For general searching across the roster, use `list_comics`, which lets you filter results by a character ID. **Comic Details:** The `get_comic` tool returns deep details on any specific comic: its title, issue number, format (like hardcover or TPB), cover date, and who wrote it. If you're just trying to find out what comics exist, use `list_comics` to see titles, issue numbers, formats, and dates; remember, you can filter that list by a character ID too. **Mapping Story Events:** Need to know what went down during a huge crossover like Civil War? The `get_event` tool maps out major story arcs. It provides the event's title, date range, detailed description, and lists all the core comics and characters involved using an event ID. To find these big sagas first, you run `list_events`, searching by name or character. **Tracking Series Runs:** If a comic line is running long, the `get_series` tool gives you the full rundown on that series. It reports its run years, total issue count, and all related content using the series ID. You can find the right series to check with `list_series`, which searches by title or character name. **Researching Creators:** Want to know every book a certain writer or artist touched? The `get_creator` tool looks up writers or artists using their numeric ID, showing you every single comic and event they contributed to. Before you can dig into specific works, you gotta find the creator's ID first. Use `list_creators` by name prefix to locate those IDs. **The Full Stack:** You can also get a general list of all available series using `list_series`, which searches for titles or character names to grab that necessary series ID for deeper lookups. The whole setup means your agent doesn't just read data; it connects everything. It links characters to the comics they're in, those comics to the events they belong to, and every single piece back to the creator who drew or wrote it. When you're done with a character, you can always run `get_character` again to pull up their bio, image link, and list of related comics. When you want general comic info, use `get_comic`. If you wanna search for anything by name without knowing the ID—be it an event, series, or creator—you've got dedicated `list_*` functions ready to go. ## Tools ### get_character Gets one Marvel character's full bio, image link, and list of related comics/series using the character ID. ### get_comic Retrieves a specific comic's data—title, issue number, format, date, creators, and characters—by its unique ID. ### get_creator Looks up a writer or artist by their numeric ID to see every series, event, and comic they contributed to. ### get_event Maps out major crossovers (like Secret Wars), returning the title, dates, description, and involved comics/characters by event ID. ### get_series Gathers details on a comic series—its run years, total issue count, and related content—by its ID. ### list_characters Searches for character IDs and names. Use this first if you don't know the specific ID of the hero you want to query. ### list_comics Finds comic titles, issue numbers, formats, and dates. You can filter results by a character using their ID here. ### list_creators Searches for creators (writers/artists) by name prefix to find their IDs before querying specific works. ### list_events Finds major story arcs and crossover events by searching names or characters, returning event titles and date ranges. ### list_series Searches for comic series by title or character name to get the series ID needed for deeper lookups. ## Prompt Examples **Prompt:** ``` Find all characters whose names start with 'Iron'. ``` **Response:** ``` Found 5 characters: Iron Man (Tony Stark) - Genius billionaire inventor in a powered suit of armor, Iron Fist (Danny Rand) - Martial artist with mystical chi-powered fist, Iron Patriot, Ironheart (Riri Williams) - Teen genius who built her own armor, and Iron Lad (young Kang variant). ``` **Prompt:** ``` What comics feature the X-Men? ``` **Response:** ``` I found 200+ comics featuring the X-Men character (ID 1009726). Recent titles include 'X-Men #25' (2024), 'X-Men: Red', 'Uncanny X-Men', 'New Mutants' and 'X-Factor'. Results include issue numbers, formats (comic, hardcover, trade paperback), cover dates and prices. ``` **Prompt:** ``` Tell me about the Civil War event. ``` **Response:** ``` Civil War (2006-2007) was a major Marvel crossover event written by Mark Millar with art by Steve McNiven. The conflict divided heroes over the Superhuman Registration Act, pitting Iron Man against Captain America. The event spanned 7 main issues and over 100 tie-in comics across multiple series. ``` ## Capabilities ### Query Character Profiles Gets a character’s full bio, image URL, and a list of all comics they appeared in. ### Find Comic Details Returns specific comic info: title, issue number, format (hardcover/TPB), cover date, and who wrote it. ### Map Major Story Events Provides details on crossover events—the dates, the description, and the core comics involved (e.g., Civil War). ### Track Comic Runs or Series Gathers information about ongoing comic series, including their start/end years and total issue count. ### Research Creators' Work Looks up writers, artists, and editors by ID to see what specific comics and events they contributed to. ## Use Cases ### Determining a Character's Origin Arc A writer needs to know the full history of Iron Man. They ask their agent: 'What are all the comics featuring Iron Man?' The agent runs `list_characters` (to get ID), then uses `list_comics` and `get_character` to compile a list of titles, issue numbers, and key dates for the writer. ### Checking a Creator's Availability A publisher needs to know if Stan Lee worked on any comics with Doctor Strange. They ask the agent: 'Show me all comics involving Doctor Strange by Stan Lee.' The agent uses `list_creators` (to get IDs), then runs `get_creator`, and finally filters results using `get_comic`. The problem is solved in one chat prompt. ### Mapping a Major Crossover A student researching comic lore needs to know the full scope of 'Secret Wars.' They ask their agent: 'Tell me about Secret Wars.' The agent uses `list_events` (to find ID), then runs `get_event`, which returns dates, involved characters, and a list of core comics. ### Verifying a Collection Gap A collector has partial records for the X-Men series. They ask: 'What are all issues in the X-Men comic line from 2015 to 2018?' The agent uses `list_series` (to find ID), then runs `get_series`, which gives them the full run history, allowing them to spot gaps. ## Benefits - Stop guessing lore details. Use `get_character` to instantly pull a hero's full bio and list of all appearances. You get the facts, not vague summaries. - Never miss an issue again. Running `list_comics` allows you to filter by character or title, giving you precise data on format, dates, and prices for tracking collections. - See how stories connect. The `get_event` tool maps out massive crossover events (like Civil War), showing exactly which characters and comics were involved in the whole mess. - Build a creator's bibliography. Use `list_creators` to find an artist or writer's ID, then use `get_creator` to get a complete record of their contributions across decades. - Avoid deep-diving into wikis. Your agent uses `list_series` and `get_series` to quickly define the scope—when did this comic line start? How many issues are there? - Process complex queries in one go. You don't need to manually jump between character, series, and event pages; your AI client does it for you. ## How It Works The bottom line is: your agent handles all the API calls so you just get a clean, written answer without seeing raw JSON. 1. Subscribe to the server and input your Marvel Public and Private API Keys. 2. Your AI client sends a request (e.g., 'Tell me about Civil War'). 3. The agent runs the necessary tools (`get_event`, `list_comics`, etc.) and returns structured data directly in the chat. ## Frequently Asked Questions **How do I get Marvel API keys?** Visit [**developer.marvel.com/account**](https://developer.marvel.com/account), sign in with a Marvel or social account, and you'll immediately see your Public and Private keys. Both are required for authentication. **Can I search for characters by name?** Yes! Use `list_characters` with `name_starts_with` to search. For example, 'Spider' returns Spider-Man (Peter Parker), Spider-Man (Miles Morales), Spider-Gwen and more. Each result includes the character ID for use with other tools. **Can I find comics for a specific character?** Yes! Use `list_comics` with `character_id`. First find the character ID with `list_characters`, then pass it to `list_comics` to get all their comic appearances with issue numbers, titles and cover dates. **How many results can I get at once?** The API supports up to 100 results per request. Use the `limit` parameter (1-100, default 20) and `offset` for pagination. The total count is returned in each response so you know how many pages exist. **How do I handle large datasets when searching for comics using `list_comics`?** You need to use the offset parameter. The API limits results to 100, so your agent must iteratively call the tool, incrementing the offset with each request until all desired issues are retrieved. **What information is required before using `get_character`?** You must first use `list_characters` to find the character's unique ID. The `get_character` tool requires this specific numeric identifier, not just the name. **If I provide an invalid or non-existent ID to `get_event`, what should my agent expect?** The tool returns a structured error object. Your AI client must check for standard API failure codes indicating that the provided ID does not map to any known Marvel event. **Can I refine searches using `list_creators` if I only know their primary role, like 'Writer'?** The tool primarily accepts name prefix search criteria. It doesn't take roles as a direct filter parameter; you must perform the initial list and then filter the resulting data set.