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.

Marvel Comics MCP Server for Mastra AI 10 tools — connect in under 2 minutes

Name: Marvel Comics
Availability: InStock
Author: Vinkius

docs.mastra.ai/docs/agents/mcp-tools

Built by Vinkius GDPR 10 Tools SDK

Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Marvel Comics through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

typescript

import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";

async function main() {
  // Your Vinkius token. get it at cloud.vinkius.com
  const mcpClient = await createMCPClient({
    servers: {
      "marvel-comics": {
        url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
      },
    },
  });

  const tools = await mcpClient.getTools();
  const agent = new Agent({
    name: "Marvel Comics Agent",
    instructions:
      "You help users interact with Marvel Comics " +
      "using 10 tools.",
    model: openai("gpt-4o"),
    tools,
  });

  const result = await agent.generate(
    "What can I do with Marvel Comics?"
  );
  console.log(result.text);
}

main();

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Marvel Comics MCP Server

Connect to the Marvel Comics API and explore the entire Marvel universe through natural conversation.

Mastra's agent abstraction provides a clean separation between LLM logic and Marvel Comics tool infrastructure. Connect 10 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.

What you can do

Characters — Search and discover Marvel characters (Spider-Man, Iron Man, X-Men, Avengers) with bios and images
Comics — Find specific comics by title or browse by character, with issue numbers, formats and cover dates
Series — Explore comic series from classic runs to modern limited series with start/end years
Events — Discover major crossover events (Civil War, Secret Wars, Infinity War) with involved comics and characters
Creators — Find writers, artists, editors and colorists who brought Marvel stories to life

The Marvel Comics MCP Server exposes 10 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Marvel Comics to Mastra AI via MCP

Follow these steps to integrate the Marvel Comics MCP Server with Mastra AI.

Install dependencies

Run npm install @mastra/core @mastra/mcp @ai-sdk/openai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save to agent.ts and run with npx tsx agent.ts

Explore tools

Mastra discovers 10 tools from Marvel Comics via MCP

Why Use Mastra AI with the Marvel Comics MCP Server

Mastra AI provides unique advantages when paired with Marvel Comics through the Model Context Protocol.

Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Marvel Comics without touching business code

Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation

TypeScript-native: full type inference for every Marvel Comics tool response with IDE autocomplete and compile-time checks

One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure

Marvel Comics + Mastra AI Use Cases

Practical scenarios where Mastra AI combined with the Marvel Comics MCP Server delivers measurable value.

Automated workflows: build multi-step agents that query Marvel Comics, process results, and trigger downstream actions in a typed pipeline

SaaS integrations: embed Marvel Comics as a first-class tool in your product's AI features with Mastra's clean agent API

Background jobs: schedule Mastra agents to query Marvel Comics on a cron and store results in your database automatically

Multi-agent systems: create specialist agents that collaborate using Marvel Comics tools alongside other MCP servers

Marvel Comics MCP Tools for Mastra AI (10)

These 10 tools become available when you connect Marvel Comics to Mastra AI via MCP:

get_character

Returns the character name, description, thumbnail image URL, comics appearances, series, events and related creators. Use list_characters to find character IDs by name first. Get a Marvel character by ID

get_comic

Returns the comic title, description, issue number, format, publication date, prices, creators and characters. Use list_comics to find comic IDs first. Get a Marvel comic by ID

get_creator

) by their numeric ID. Returns their full name, role, comics worked on, series and events. Use list_creators to find creator IDs by name first. Get a Marvel creator by ID

get_event

g. "Civil War", "Secret Wars", "Infinity War"). Returns the event title, description, start/end dates, number of comics/series/characters involved and thumbnail. Get a Marvel event by ID

get_series

Returns the series title, description, start/end years, number of issues, thumbnail and related content. Get a Marvel series by ID

list_characters

Returns character IDs, names, descriptions and thumbnail images. Useful for discovering character IDs to use with get_character, get_comics (by character) and other tools. Optionally set limit (max 100) and offset for pagination. Search Marvel characters by name

list_comics

Returns comic titles, issue numbers, formats, publication dates and cover images. Optionally filter by a specific character using their ID. Set limit (max 100) and offset for pagination. Search Marvel comics by title or character

list_creators

) by first or last name prefix. Returns creator IDs, full names, thumbnails and their primary roles. Useful for discovering who worked on specific comics. Set limit (max 100) for pagination. Search Marvel creators by name

list_events

Returns event titles, descriptions, start/end dates and number of involved comics/series. Useful for discovering major story arcs. Set limit (max 100) for pagination. Search Marvel events by name or character

list_series

Returns series titles, start/end years, issue counts and thumbnails. Useful for finding ongoing series and limited runs. Set limit (max 100) for pagination. Search Marvel series by title or character