[{"_1":2,"_286":-5,"_287":-5},"loaderData",{"_3":4,"_20":21,"_22":23,"_24":25,"_227":228},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":-5,"_17":18,"_19":-5},"attributes",[15],"BOT","membership","uid","9ReKOtIL4f","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":-5,"_27":28,"_29":30,"_146":147},"githubUser","maintainer",false,"mcpServer",{"_31":32,"_33":34,"_13":54,"_61":62,"_63":62,"_64":65,"_70":71,"_93":-5,"_94":95,"_96":28,"_97":98,"_80":116,"_117":85,"_118":119,"_123":-5,"_124":-5,"_125":126,"_133":-5,"_134":135,"_140":-5,"_105":81,"_141":-5,"_142":-5,"_17":143,"_144":145},"addedAt",["D",1743364382869],"argumentsJsonSchema",{"_35":36,"_51":52,"_43":53},"properties",{"_37":38,"_45":46,"_48":49},"MARVEL_API_BASE",{"_39":40,"_41":42,"_43":44},"default","https://gateway.marvel.com/v1/public","description","The base URL for the Marvel API","type","string","MARVEL_PUBLIC_KEY",{"_41":47,"_43":44},"Your Marvel API public key from developer.marvel.com","MARVEL_PRIVATE_KEY",{"_41":50,"_43":44},"Your Marvel API private key from developer.marvel.com","required",[45,48],"object",[55,56,57,58,59,60],"category:search","category:art-and-culture","author:claimed","hosting:remote-capable","language:typescript","license_grade:a","descriptionMarkdown","MCP Server for the Marvel Developer API, enabling interaction with characters and comics data.","descriptionPlainText","githubProject",{"_66":67,"_68":69},"readme","

\n\n $\"\"$ \n\n# Marvel MCP Server\n\n[![Open project in GitHub Codespaces](https://img.shields.io/badge/Codespaces-Open-blue?style=flat-square&logo=github)](https://codespaces.new/danwahlin/marvel-mcp?hide_repo_select=true&ref=main&quickstart=true)\n![Node version](https://img.shields.io/badge/Node.js->=20-3c873a?style=flat-square)\n[![License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)](LICENSE)\n\n[Features](#features) • [Tools](#tools) • [Setup](#setup) • [Configuring an MCP Host](#configuring-an-mcp-host)\n\n

\n\nMCP Server for the [Marvel Developer API](https://developer.marvel.com/documentation/getting_started), enabling interaction with characters and comics data. *The main goal of the project is to show how an MCP server can be used to interact with APIs.*\n\n> **Note**: All data used by this MCP server is fetched from the [official Marvel API](https://developer.marvel.com/documentation/getting_started) and owned by Marvel. This project is not affiliated with Marvel in any way.\n\n\n## 🔧 Features\n\n- **List Marvel Characters**: Supports filters like `nameStartsWith`, `limit`, `comics`, `series`, etc.\n- **Fetch a Marvel Character by ID**: Get detailed info on any character using their `characterId`.\n- **Fetch Comics for a Character**: Get a list of comics featuring a specific character, with various filters like `format`, `dateRange`, etc.\n- **Tool-based MCP integration**: Register this server with Model Context Protocol (MCP) tools (VS Code, Claude, etc.).\n- **Environment Configuration**: Use `.env` file to manage environment variables like `MARVEL_PUBLIC_KEY`, `MARVEL_PRIVATE_KEY` and `MARVEL_API_BASE`.\n\n\n## 🧰 Tools\n\n### 1. `get_characters` 🔍🦸‍♂️\n- **Description**: Fetch Marvel characters with optional filters.\n- **Inputs**:\n - `name` (optional string): Full character name.\n - `nameStartsWith` (optional string): Characters whose names start with the specified string.\n - `modifiedSince` (optional string): ISO 8601 date string to filter characters modified since this date.\n - `comics`, `series`, `events`, `stories` (optional string): Comma-separated list of IDs to filter by related entities.\n - `orderBy` (optional string): Fields to order the results by, such as `name` or `-modified`.\n - `limit` (optional number): Maximum number of results to return (1–100).\n - `offset` (optional number): Number of results to skip for pagination.\n- **Returns**: JSON response with matching characters. See `CharacterDataWrapperSchema` in `src/schemas.ts` for details.\n\n### 2. `get_character_by_id` 🆔🧑‍🎤\n- **Description**: Fetch a Marvel character by their unique ID.\n- **Input**:\n - `characterId` (number): The unique ID of the character.\n- **Returns**: JSON response with the character's details. See `CharacterDataWrapperSchema` in `src/schemas.ts` for details.\n\n### 3. `get_comics_for_character` 📚🎭\n- **Description**: Fetch comics featuring a specific character, with optional filters.\n- **Inputs**:\n - `characterId` (number): The unique ID of the character.\n - Optional filters:\n - `format`, `formatType` (string): Filter by comic format (e.g., `comic`, `hardcover`).\n - `noVariants`, `hasDigitalIssue` (boolean): Flags to exclude variants or include only digital issues.\n - `dateDescriptor` (string): Predefined date ranges like `thisWeek`, `nextWeek`.\n - `dateRange` (string): Custom date range in the format `YYYY-MM-DD,YYYY-MM-DD`.\n - `title`, `titleStartsWith` (string): Filter by title or title prefix.\n - `startYear`, `issueNumber`, `digitalId` (number): Numeric filters.\n - `diamondCode`, `upc`, `isbn`, `ean`, `issn` (string): Identifier filters.\n - `creators`, `series`, `events`, `stories`, `sharedAppearances`, `collaborators` (string): Comma-separated list of related entity IDs.\n - `orderBy` (string): Fields to order the results by, such as `title` or `-modified`.\n - `limit`, `offset` (number): Pagination options.\n- **Returns**: JSON response with comics featuring the specified character. See `ComicDataWrapperSchema` in `src/schemas.ts` for details.\n\n### 4. `get_comics` 📖🕵️‍♂️\n- **Description**: Fetch lists of Marvel comics with optional filters.\n- **Inputs**:\n - `format` (optional string): Filter by the issue format (e.g., `comic`, `digital comic`, `hardcover`).\n - `formatType` (optional string): Filter by the issue format type (`comic` or `collection`).\n - `noVariants` (optional boolean): Exclude variants (alternate covers, secondary printings, director's cuts, etc.) from the result set.\n - `dateDescriptor` (optional string): Return comics within a predefined date range (`lastWeek`, `thisWeek`, `nextWeek`, `thisMonth`).\n - `dateRange` (optional string): Return comics within a custom date range. Dates must be specified as `YYYY-MM-DD,YYYY-MM-DD`.\n - `title` (optional string): Return only issues in series whose title matches the input.\n - `titleStartsWith` (optional string): Return only issues in series whose title starts with the input.\n - `startYear` (optional number): Return only issues in series whose start year matches the input.\n - `issueNumber` (optional number): Return only issues in series whose issue number matches the input.\n - `diamondCode`, `digitalId`, `upc`, `isbn`, `ean`, `issn` (optional string): Filter by various identifiers.\n - `hasDigitalIssue` (optional boolean): Include only results which are available digitally.\n - `modifiedSince` (optional string): Return only comics which have been modified since the specified date (ISO 8601 format).\n - `creators`, `characters`, `series`, `events`, `stories`, `sharedAppearances`, `collaborators` (optional string): Comma-separated list of IDs to filter by related entities.\n - `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`).\n - `limit` (optional number): Limit the result set to the specified number of resources (default: 20, max: 100).\n - `offset` (optional number): Skip the specified number of resources in the result set.\n- **Returns**: JSON response with matching comics. See `ComicDataWrapperSchema` in `src/schemas.ts` for details.\n\n### 5. `get_comic_by_id` 🆔📘\n- **Description**: Fetch a single Marvel comic by its unique ID.\n- **Input**:\n - `comicId` (number): The unique ID of the comic.\n- **Returns**: JSON response with the comic details. See `ComicDataWrapperSchema` in `src/schemas.ts` for details.\n\n### 6. `get_characters_for_comic` 🦸‍♀️📖\n- **Description**: Fetch Marvel characters appearing in a specific comic.\n- **Inputs**:\n - `comicId` (number): The unique ID of the comic.\n - Optional filters:\n - `name` (optional string): Filter characters by full name.\n - `nameStartsWith` (optional string): Filter characters whose names start with the specified string.\n - `modifiedSince` (optional string): ISO 8601 date string to filter characters modified since this date.\n - `series`, `events`, `stories` (optional string): Comma-separated list of related entity IDs to filter by.\n - `orderBy` (optional string): Fields to order the results by, such as `name` or `-modified`.\n - `limit` (optional number): Maximum number of results to return (1–100).\n - `offset` (optional number): Number of results to skip for pagination.\n- **Returns**: JSON response with characters appearing in the specified comic. See `CharacterDataWrapperSchema` in `src/schemas.ts` for details.\n\n\n## 🛠️ Setup\n\nSign up for a [Marvel Developer API](https://developer.marvel.com/documentation/getting_started) account and get your public and private API keys. \n\nIf you want to run it directly in an MCP host, jump to the [Use with Claude Desktop](#use-with-claude-desktop) or [Use with GitHub Copilot](#use-with-github-copilot) sections.\n\n### Run the Server Locally with MCP Inspector\n\nIf you'd like to run MCP Inspector locally to test the server, follow these steps:\n\n1. Clone this repository:\n\n ```bash\n git clone https://github.com/DanWahlin/marvel-mcp-server\n ```\n\n1. Rename `.env.template ` to `.env`.\n\n1. Add your Marvel API public and private keys to the `.env` file.\n\n ```bash\n MARVEL_PUBLIC_KEY=YOUR_PUBLIC_KEY\n MARVEL_PRIVATE_KEY=YOUR_PRIVATE_KEY\n MARVEL_API_BASE=https://gateway.marvel.com/v1/public\n ```\n1. Install the required dependencies and build the project.\n\n ```bash\n npm install\n npm run build\n ```\n\n1. (Optional) To try out the server using MCP Inspector run the following command:\n\n ```bash\n # Start the MCP Inspector\n npx @modelcontextprotocol/inspector node build/index.js\n ```\n\n Visit the MCP Inspector URL shown in the console in your browser. Change `Arguments` to `dist/index.js` and select `Connect`. Select `List Tools` to see the available tools.\n\n\n## Configuring an MCP Host\n\n### Use with Claude Desktop\n\nAdd the following to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"marvel-mcp\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n // \"command\": \"node\",\n \"args\": [\n \"-y\",\n \"@codewithdan/marvel-mcp\"\n // \"/PATH/TO/marvel-mcp/dist/index.js\"\n ],\n \"env\": {\n \"MARVEL_PUBLIC_KEY\": \"YOUR_PUBLIC_KEY\",\n \"MARVEL_PRIVATE_KEY\": \"YOUR_PRIVATE_KEY\",\n \"MARVEL_API_BASE\": \"https://gateway.marvel.com/v1/public\"\n }\n }\n }\n}\n```\n\n### Use with GitHub Copilot (VS Code Insiders)\n\n> **Note**: If you already have the MCP server enabled with Claude Desktop, add `chat.mcp.discovery.enabled: true` in your VS Code settings and it will discover existing MCP server lists.\n\nIf you want to associate the MCP server with a specific repo, create a `.vscode/mcp.json` file with this content:\n\n ```json\n {\n \"inputs\": [],\n \"servers\": {\n \"marvel-mcp\": {\n \"command\": \"npx\",\n // \"command\": \"node\",\n \"args\": [\n \"-y\",\n \"@codewithdan/marvel-mcp\"\n // \"/PATH/TO/marvel-mcp/dist/index.js\"\n ],\n \"env\": {\n \"MARVEL_PUBLIC_KEY\": \"YOUR_PUBLIC_KEY\",\n \"MARVEL_PRIVATE_KEY\": \"YOUR_PRIVATE_KEY\",\n \"MARVEL_API_BASE\": \"https://gateway.marvel.com/v1/public\"\n }\n }\n }\n }\n ```\n\nIf you want to associate the MCP server with all repos, add the following to your VS Code User Settings JSON:\n\n ```json\n \"mcp\": {\n \"servers\": {\n \"marvel-mcp\": {\n \"command\": \"npx\",\n // \"command\": \"node\",\n \"args\": [\n \"-y\",\n \"@codewithdan/marvel-mcp\"\n // \"/PATH/TO/marvel-mcp/dist/index.js\"\n ],\n \"env\": {\n \"MARVEL_PUBLIC_KEY\": \"YOUR_PUBLIC_KEY\",\n \"MARVEL_PRIVATE_KEY\": \"YOUR_PRIVATE_KEY\",\n \"MARVEL_API_BASE\": \"https://gateway.marvel.com/v1/public\"\n }\n },\n }\n },\n \"chat.mcp.discovery.enabled\": true,\n ```\n\n### Using Tools in GitHub Copilot\n\n1. Now that the mcp server is discoverable, open GitHub Copilot and select the `Agent` mode (not `Chat` or `Edits`).\n2. Select the \"refresh\" button in the Copilot chat text field to refresh the server list.\n3. Select the \"🛠️\" button to see all the possible tools, including the ones from this repo.\n4. Put a question in the chat that would naturally invoke one of the tools, for example: \n\n ```\n List 10 marvel characters.\n\n What comics is Wolverine in?\n \n Which characters appear in the Avengers comics?\n\n What characters are in the Hedge Knight II: Sworn Sword (2007) comic?\n ```\n\n > **Note**: If you see \"Sorry, the response was filtered by the Responsible AI Service. Please rephrase your prompt and try again.\", try running it again or rephrasing the prompt.","url","https://github.com/DanWahlin/marvel-mcp","githubRepository",{"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":83,"_87":88,"_89":90,"_92":88},"defaultBranch","main","fullName","DanWahlin/marvel-mcp","githubTreeId",104675,"language","TypeScript","name","marvel-mcp","owner",{"_84":85,"_17":86},"login","DanWahlin","IFU2Z7TM81","recentStargazers",4,"spdxLicense",{"_80":91},"MIT License","stargazers","glamaJson","id",4700,"inspectable","integrations",[99,109],{"_100":101,"_41":107,"_17":108},"brand",{"_102":103,"_80":104,"_105":106},"logoSvgPath","M24 0v24H0V0h24ZM10.933 15.89H6.84v5.52h4.198v-.93H7.955v-1.503h2.77v-.93h-2.77v-1.224h2.978v-.934Zm2.146 0h-1.084v5.52h1.035v-3.6l2.226 3.6h1.118v-5.52h-1.036v3.686l-2.259-3.687Zm5.117 0h-1.208l1.973 5.52h1.19l1.976-5.52h-1.182l-1.352 4.085-1.397-4.086ZM5.4 19.68H3.72v1.68H5.4v-1.68Z",".ENV","slug","dotenv","Supports environment configuration through .env files to manage Marvel API credentials and base URL.","uskoez45ls",{"_100":110,"_41":114,"_17":115},{"_102":111,"_80":112,"_105":113},"M23.922 16.997C23.061 18.492 18.063 22.02 12 22.02 5.937 22.02.939 18.492.078 16.997A.641.641 0 0 1 0 16.741v-2.869a.883.883 0 0 1 .053-.22c.372-.935 1.347-2.292 2.605-2.656.167-.429.414-1.055.644-1.517a10.098 10.098 0 0 1-.052-1.086c0-1.331.282-2.499 1.132-3.368.397-.406.89-.717 1.474-.952C7.255 2.937 9.248 1.98 11.978 1.98c2.731 0 4.767.957 6.166 2.093.584.235 1.077.546 1.474.952.85.869 1.132 2.037 1.132 3.368 0 .368-.014.733-.052 1.086.23.462.477 1.088.644 1.517 1.258.364 2.233 1.721 2.605 2.656a.841.841 0 0 1 .053.22v2.869a.641.641 0 0 1-.078.256Zm-11.75-5.992h-.344a4.359 4.359 0 0 1-.355.508c-.77.947-1.918 1.492-3.508 1.492-1.725 0-2.989-.359-3.782-1.259a2.137 2.137 0 0 1-.085-.104L4 11.746v6.585c1.435.779 4.514 2.179 8 2.179 3.486 0 6.565-1.4 8-2.179v-6.585l-.098-.104s-.033.045-.085.104c-.793.9-2.057 1.259-3.782 1.259-1.59 0-2.738-.545-3.508-1.492a4.359 4.359 0 0 1-.355-.508Zm2.328 3.25c.549 0 1 .451 1 1v2c0 .549-.451 1-1 1-.549 0-1-.451-1-1v-2c0-.549.451-1 1-1Zm-5 0c.549 0 1 .451 1 1v2c0 .549-.451 1-1 1-.549 0-1-.451-1-1v-2c0-.549.451-1 1-1Zm3.313-6.185c.136 1.057.403 1.913.878 2.497.442.544 1.134.938 2.344.938 1.573 0 2.292-.337 2.657-.751.384-.435.558-1.15.558-2.361 0-1.14-.243-1.847-.705-2.319-.477-.488-1.319-.862-2.824-1.025-1.487-.161-2.192.138-2.533.529-.269.307-.437.808-.438 1.578v.021c0 .265.021.562.063.893Zm-1.626 0c.042-.331.063-.628.063-.894v-.02c-.001-.77-.169-1.271-.438-1.578-.341-.391-1.046-.69-2.533-.529-1.505.163-2.347.537-2.824 1.025-.462.472-.705 1.179-.705 2.319 0 1.211.175 1.926.558 2.361.365.414 1.084.751 2.657.751 1.21 0 1.902-.394 2.344-.938.475-.584.742-1.44.878-2.497Z","GitHub Copilot","github-copilot","Allows GitHub Copilot to access Marvel characters and comics data through the Marvel Developer API, supporting various filters and search capabilities.","0jkilrg5nq","Marvel MCP","namespace","npmPackage",{"_80":120,"_121":122},"@codewithdan/marvel-mcp","weeklyDownloads",146,"prompts","redditPostForeignId","relatedMcpServerIds",[127,128,129,130,131,132],1006,1776,535,1775,1848,3529,"resources","scores",{"_136":137,"_138":-5,"_139":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms","tools","3f8e47gp7v","updatedAt",["D",1743472832973],"meta",[148,151,153,160,163,165,168,171,174,177,180,182,185,188,190,192,194,196,198],{"_149":150},"title","Marvel MCP | Glama",{"_152":62,"_80":41},"content",{"_154":155,"_156":157,"_158":159},"href","https://glama.ai/mcp/servers/@DanWahlin/marvel-mcp","rel","canonical","tagName","link",{"_152":116,"_161":162},"property","og:title",{"_152":62,"_161":164},"og:description",{"_152":166,"_161":167},"https://glama.ai/logo.png","og:logo",{"_152":169,"_161":170},"https://glama.ai/mcp/servers/@DanWahlin/marvel-mcp/og-image","og:image",{"_152":172,"_161":173},"630","og:image:height",{"_152":175,"_161":176},"1200","og:image:width",{"_152":178,"_161":179},"website","og:type",{"_152":155,"_161":181},"og:url",{"_152":183,"_161":184},"ChatGPT alternative for power users","og:site_name",{"_152":186,"_80":187},"summary_large_image","twitter:card",{"_152":183,"_80":189},"twitter:title",{"_152":62,"_80":191},"twitter:description",{"_152":169,"_80":193},"twitter:image",{"_152":172,"_80":195},"twitter:image:height",{"_152":175,"_80":197},"twitter:image:width",{"_199":200},"script:ld+json",{"_201":202,"_203":204},"@context","http://schema.org","@graph",[205],{"_201":206,"_207":208,"_209":210},"https://schema.org","@type","BreadcrumbList","itemListElement",[211,218,222,226],{"_207":212,"_213":214,"_80":215,"_216":217},"ListItem","item","https://glama.ai/","Glama","position",1,{"_207":212,"_213":219,"_80":220,"_216":221},"https://glama.ai/mcp","MCP",2,{"_207":212,"_213":223,"_80":224,"_216":225},"https://glama.ai/mcp/servers","Servers",3,{"_207":212,"_213":155,"_80":116,"_216":88},"routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_26":-5,"_29":229,"_146":251,"_285":-5},{"_31":230,"_33":231,"_13":237,"_61":62,"_63":62,"_64":238,"_70":239,"_93":-5,"_94":95,"_96":28,"_97":242,"_80":116,"_117":85,"_118":247,"_123":-5,"_124":-5,"_125":248,"_133":-5,"_134":249,"_140":-5,"_105":81,"_141":-5,"_142":-5,"_17":143,"_144":250},["D",1743364382869],{"_35":232,"_51":236,"_43":53},{"_37":233,"_45":234,"_48":235},{"_39":40,"_41":42,"_43":44},{"_41":47,"_43":44},{"_41":50,"_43":44},[45,48],[55,56,57,58,59,60],{"_66":67,"_68":69},{"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":240,"_87":88,"_89":241,"_92":88},{"_84":85,"_17":86},{"_80":91},[243,245],{"_100":244,"_41":107,"_17":108},{"_102":103,"_80":104,"_105":106},{"_100":246,"_41":114,"_17":115},{"_102":111,"_80":112,"_105":113},{"_80":120,"_121":122},[127,128,129,130,131,132],{"_136":137,"_138":-5,"_139":-5},["D",1743472832973],[252,254,255,257,259,260,261,262,263,264,265,266,267,268,269,270,271,272,273],{"_149":253},"Reviews | Marvel MCP | Glama",{"_152":62,"_80":41},{"_154":256,"_156":157,"_158":159},"https://glama.ai/mcp/servers/@DanWahlin/marvel-mcp/reviews",{"_152":258,"_161":162},"Reviews | Marvel MCP",{"_152":62,"_161":164},{"_152":166,"_161":167},{"_152":169,"_161":170},{"_152":172,"_161":173},{"_152":175,"_161":176},{"_152":178,"_161":179},{"_152":256,"_161":181},{"_152":183,"_161":184},{"_152":186,"_80":187},{"_152":183,"_80":189},{"_152":62,"_80":191},{"_152":169,"_80":193},{"_152":172,"_80":195},{"_152":175,"_80":197},{"_199":274},{"_201":202,"_203":275},[276],{"_201":206,"_207":208,"_209":277},[278,279,280,281,282],{"_207":212,"_213":214,"_80":215,"_216":217},{"_207":212,"_213":219,"_80":220,"_216":221},{"_207":212,"_213":223,"_80":224,"_216":225},{"_207":212,"_213":155,"_80":116,"_216":88},{"_207":212,"_213":256,"_80":283,"_216":284},"Reviews",5,"review","actionData","errors"]

Rate & Review