[{"_1":2,"_295":-5,"_296":-5},"loaderData",{"_3":4,"_28":29,"_30":31,"_32":33,"_233":234},"root",{"_5":6,"_16":17},"toasts",[7,14],{"_8":9,"_10":11,"_12":13},"uid","67a61186-4f62-45c4-a24a-90270c82d3ae","title","This MCP server does not support inspection","type","error",{"_8":15,"_10":11,"_12":13},"03e256fa-1d41-4a2e-9d41-e09d27e58f0f","visitor",{"_18":19,"_20":21},"viewportWidth",1280,"visitorSession",{"_22":23,"_25":-5,"_8":26,"_27":-5},"attributes",[24],"BOT","membership","9ReKOtIL4f","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_34":-5,"_35":36,"_37":38,"_153":154},"githubUser","maintainer",false,"mcpServer",{"_39":40,"_41":42,"_22":61,"_68":69,"_70":69,"_71":72,"_77":78,"_100":-5,"_101":102,"_103":36,"_104":105,"_87":123,"_124":92,"_125":126,"_130":-5,"_131":-5,"_132":133,"_140":-5,"_141":142,"_147":-5,"_112":88,"_148":-5,"_149":-5,"_8":150,"_151":152},"addedAt",["D",1743364382869],"argumentsJsonSchema",{"_43":44,"_58":59,"_12":60},"properties",{"_45":46,"_52":53,"_55":56},"MARVEL_API_BASE",{"_47":48,"_49":50,"_12":51},"default","https://gateway.marvel.com/v1/public","description","The base URL for the Marvel API","string","MARVEL_PUBLIC_KEY",{"_49":54,"_12":51},"Your Marvel API public key from developer.marvel.com","MARVEL_PRIVATE_KEY",{"_49":57,"_12":51},"Your Marvel API private key from developer.marvel.com","required",[52,55],"object",[62,63,64,65,66,67],"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",{"_73":74,"_75":76},"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",{"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_94":95,"_96":97,"_99":95},"defaultBranch","main","fullName","DanWahlin/marvel-mcp","githubTreeId",104675,"language","TypeScript","name","marvel-mcp","owner",{"_91":92,"_8":93},"login","DanWahlin","IFU2Z7TM81","recentStargazers",4,"spdxLicense",{"_87":98},"MIT License","stargazers","glamaJson","id",4700,"inspectable","integrations",[106,116],{"_107":108,"_49":114,"_8":115},"brand",{"_109":110,"_87":111,"_112":113},"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",{"_107":117,"_49":121,"_8":122},{"_109":118,"_87":119,"_112":120},"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",{"_87":127,"_128":129},"@codewithdan/marvel-mcp","weeklyDownloads",146,"prompts","redditPostForeignId","relatedMcpServerIds",[134,135,136,137,138,139],1006,1776,535,1775,1848,3529,"resources","scores",{"_143":144,"_145":-5,"_146":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms","tools","3f8e47gp7v","updatedAt",["D",1743472832973],"meta",[155,157,159,166,169,171,174,177,180,183,186,188,191,194,196,198,200,202,204],{"_10":156},"Marvel MCP | Glama",{"_158":69,"_87":49},"content",{"_160":161,"_162":163,"_164":165},"href","https://glama.ai/mcp/servers/@DanWahlin/marvel-mcp","rel","canonical","tagName","link",{"_158":123,"_167":168},"property","og:title",{"_158":69,"_167":170},"og:description",{"_158":172,"_167":173},"https://glama.ai/logo.png","og:logo",{"_158":175,"_167":176},"https://glama.ai/mcp/servers/@DanWahlin/marvel-mcp/og-image","og:image",{"_158":178,"_167":179},"630","og:image:height",{"_158":181,"_167":182},"1200","og:image:width",{"_158":184,"_167":185},"website","og:type",{"_158":161,"_167":187},"og:url",{"_158":189,"_167":190},"ChatGPT alternative for power users","og:site_name",{"_158":192,"_87":193},"summary_large_image","twitter:card",{"_158":189,"_87":195},"twitter:title",{"_158":69,"_87":197},"twitter:description",{"_158":175,"_87":199},"twitter:image",{"_158":178,"_87":201},"twitter:image:height",{"_158":181,"_87":203},"twitter:image:width",{"_205":206},"script:ld+json",{"_207":208,"_209":210},"@context","http://schema.org","@graph",[211],{"_207":212,"_213":214,"_215":216},"https://schema.org","@type","BreadcrumbList","itemListElement",[217,224,228,232],{"_213":218,"_219":220,"_87":221,"_222":223},"ListItem","item","https://glama.ai/","Glama","position",1,{"_213":218,"_219":225,"_87":226,"_222":227},"https://glama.ai/mcp","MCP",2,{"_213":218,"_219":229,"_87":230,"_222":231},"https://glama.ai/mcp/servers","Servers",3,{"_213":218,"_219":161,"_87":123,"_222":95},"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~branch/~/_route",{"_235":236,"_240":80,"_37":241,"_263":264,"_265":266},"blob",{"_158":237,"_238":239},"node_modules\nnpm-debug.log\n\n\n.idea\n.vs\n.env\n.DS_Store\nThumbs.db\n\n# Ignore any generated files\ndist\nbuild\ntsconfig.tsbuildinfo","fileName",".gitignore","branch",{"_39":242,"_41":243,"_22":249,"_68":69,"_70":69,"_71":250,"_77":251,"_100":-5,"_101":102,"_103":36,"_104":254,"_87":123,"_124":92,"_125":259,"_130":-5,"_131":-5,"_132":260,"_140":-5,"_141":261,"_147":-5,"_112":88,"_148":-5,"_149":-5,"_8":150,"_151":262},["D",1743364382869],{"_43":244,"_58":248,"_12":60},{"_45":245,"_52":246,"_55":247},{"_47":48,"_49":50,"_12":51},{"_49":54,"_12":51},{"_49":57,"_12":51},[52,55],[62,63,64,65,66,67],{"_73":74,"_75":76},{"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":252,"_94":95,"_96":253,"_99":95},{"_91":92,"_8":93},{"_87":98},[255,257],{"_107":256,"_49":114,"_8":115},{"_109":110,"_87":111,"_112":113},{"_107":258,"_49":121,"_8":122},{"_109":118,"_87":119,"_112":120},{"_87":127,"_128":129},[134,135,136,137,138,139],{"_143":144,"_145":-5,"_146":-5},["D",1743472832973],"path","","treeMembers",[267,270,272,274,276,278,280,282,283,285,287,289,291,293],{"_263":268,"_12":269},".github","tree",{"_263":271,"_12":269},"images",{"_263":273,"_12":269},"src",{"_263":275,"_12":235},"CHANGELOG.md",{"_263":277,"_12":235},"Dockerfile",{"_263":279,"_12":235},".editorconfig",{"_263":281,"_12":235},".env.template",{"_263":239,"_12":235},{"_263":284,"_12":235},"LICENSE",{"_263":286,"_12":235},"marvel-openapi.json",{"_263":288,"_12":235},"package.json",{"_263":290,"_12":235},"package-lock.json",{"_263":292,"_12":235},"README.md",{"_263":294,"_12":235},"tsconfig.json","actionData","errors"]