[{"_1":2,"_293":-5,"_294":-5},"loaderData",{"_3":4,"_26":27,"_28":29,"_30":31,"_231":232},"root",{"_5":6,"_14":15},"toasts",[7],{"_8":9,"_10":11,"_12":13},"uid","e0693abc-16c4-4050-8141-dfa16ee635e3","title","This MCP server does not support inspection","type","error","visitor",{"_16":17,"_18":19},"viewportWidth",1280,"visitorSession",{"_20":21,"_23":-5,"_8":24,"_25":-5},"attributes",[22],"BOT","membership","6zS84Jhv0j","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_32":-5,"_33":34,"_35":36,"_151":152},"githubUser","maintainer",false,"mcpServer",{"_37":38,"_39":40,"_20":59,"_66":67,"_68":67,"_69":70,"_75":76,"_98":-5,"_99":100,"_101":34,"_102":103,"_85":121,"_122":90,"_123":124,"_128":-5,"_129":-5,"_130":131,"_138":-5,"_139":140,"_145":-5,"_110":86,"_146":-5,"_147":-5,"_8":148,"_149":150},"addedAt",["D",1743364382869],"argumentsJsonSchema",{"_41":42,"_56":57,"_12":58},"properties",{"_43":44,"_50":51,"_53":54},"MARVEL_API_BASE",{"_45":46,"_47":48,"_12":49},"default","https://gateway.marvel.com/v1/public","description","The base URL for the Marvel API","string","MARVEL_PUBLIC_KEY",{"_47":52,"_12":49},"Your Marvel API public key from developer.marvel.com","MARVEL_PRIVATE_KEY",{"_47":55,"_12":49},"Your Marvel API private key from developer.marvel.com","required",[50,53],"object",[60,61,62,63,64,65],"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",{"_71":72,"_73":74},"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",{"_77":78,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_92":93,"_94":95,"_97":93},"defaultBranch","main","fullName","DanWahlin/marvel-mcp","githubTreeId",104675,"language","TypeScript","name","marvel-mcp","owner",{"_89":90,"_8":91},"login","DanWahlin","IFU2Z7TM81","recentStargazers",4,"spdxLicense",{"_85":96},"MIT License","stargazers","glamaJson","id",4700,"inspectable","integrations",[104,114],{"_105":106,"_47":112,"_8":113},"brand",{"_107":108,"_85":109,"_110":111},"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",{"_105":115,"_47":119,"_8":120},{"_107":116,"_85":117,"_110":118},"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",{"_85":125,"_126":127},"@codewithdan/marvel-mcp","weeklyDownloads",146,"prompts","redditPostForeignId","relatedMcpServerIds",[132,133,134,135,136,137],1006,1776,535,1775,1848,3529,"resources","scores",{"_141":142,"_143":-5,"_144":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms","tools","3f8e47gp7v","updatedAt",["D",1743472832973],"meta",[153,155,157,164,167,169,172,175,178,181,184,186,189,192,194,196,198,200,202],{"_10":154},"Marvel MCP | Glama",{"_156":67,"_85":47},"content",{"_158":159,"_160":161,"_162":163},"href","https://glama.ai/mcp/servers/@DanWahlin/marvel-mcp","rel","canonical","tagName","link",{"_156":121,"_165":166},"property","og:title",{"_156":67,"_165":168},"og:description",{"_156":170,"_165":171},"https://glama.ai/logo.png","og:logo",{"_156":173,"_165":174},"https://glama.ai/mcp/servers/@DanWahlin/marvel-mcp/og-image","og:image",{"_156":176,"_165":177},"630","og:image:height",{"_156":179,"_165":180},"1200","og:image:width",{"_156":182,"_165":183},"website","og:type",{"_156":159,"_165":185},"og:url",{"_156":187,"_165":188},"ChatGPT alternative for power users","og:site_name",{"_156":190,"_85":191},"summary_large_image","twitter:card",{"_156":187,"_85":193},"twitter:title",{"_156":67,"_85":195},"twitter:description",{"_156":173,"_85":197},"twitter:image",{"_156":176,"_85":199},"twitter:image:height",{"_156":179,"_85":201},"twitter:image:width",{"_203":204},"script:ld+json",{"_205":206,"_207":208},"@context","http://schema.org","@graph",[209],{"_205":210,"_211":212,"_213":214},"https://schema.org","@type","BreadcrumbList","itemListElement",[215,222,226,230],{"_211":216,"_217":218,"_85":219,"_220":221},"ListItem","item","https://glama.ai/","Glama","position",1,{"_211":216,"_217":223,"_85":224,"_220":225},"https://glama.ai/mcp","MCP",2,{"_211":216,"_217":227,"_85":228,"_220":229},"https://glama.ai/mcp/servers","Servers",3,{"_211":216,"_217":159,"_85":121,"_220":93},"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~branch/~/_route",{"_233":234,"_238":78,"_35":239,"_261":262,"_263":264},"blob",{"_156":235,"_236":237},"MARVEL_PUBLIC_KEY=\nMARVEL_PRIVATE_KEY=\nMARVEL_API_BASE=https://gateway.marvel.com/v1/public","fileName",".env.template","branch",{"_37":240,"_39":241,"_20":247,"_66":67,"_68":67,"_69":248,"_75":249,"_98":-5,"_99":100,"_101":34,"_102":252,"_85":121,"_122":90,"_123":257,"_128":-5,"_129":-5,"_130":258,"_138":-5,"_139":259,"_145":-5,"_110":86,"_146":-5,"_147":-5,"_8":148,"_149":260},["D",1743364382869],{"_41":242,"_56":246,"_12":58},{"_43":243,"_50":244,"_53":245},{"_45":46,"_47":48,"_12":49},{"_47":52,"_12":49},{"_47":55,"_12":49},[50,53],[60,61,62,63,64,65],{"_71":72,"_73":74},{"_77":78,"_79":80,"_81":82,"_83":84,"_85":86,"_87":250,"_92":93,"_94":251,"_97":93},{"_89":90,"_8":91},{"_85":96},[253,255],{"_105":254,"_47":112,"_8":113},{"_107":108,"_85":109,"_110":111},{"_105":256,"_47":119,"_8":120},{"_107":116,"_85":117,"_110":118},{"_85":125,"_126":127},[132,133,134,135,136,137],{"_141":142,"_143":-5,"_144":-5},["D",1743472832973],"path","","treeMembers",[265,268,270,272,274,276,278,279,281,283,285,287,289,291],{"_261":266,"_12":267},".github","tree",{"_261":269,"_12":267},"images",{"_261":271,"_12":267},"src",{"_261":273,"_12":233},"CHANGELOG.md",{"_261":275,"_12":233},"Dockerfile",{"_261":277,"_12":233},".editorconfig",{"_261":237,"_12":233},{"_261":280,"_12":233},".gitignore",{"_261":282,"_12":233},"LICENSE",{"_261":284,"_12":233},"marvel-openapi.json",{"_261":286,"_12":233},"package.json",{"_261":288,"_12":233},"package-lock.json",{"_261":290,"_12":233},"README.md",{"_261":292,"_12":233},"tsconfig.json","actionData","errors"]