Marvel Rivals

You can access Marvel Rivals game data through a dedicated MCP (Model Context Protocol) server that exposes a standardized interface for common actions like listing heroes, retrieving hero details, and checking player data. This server lets you build powerful assistants and tools that leverage Marvel Rivals data without needing to implement custom APIs.

How to use

You interact with the Marvel Rivals MCP using an MCP client. Once the server is running, you can perform actions such as listing heroes, fetching hero information and abilities, browsing skins, querying items and maps, and retrieving player profiles and match history. Each action corresponds to a specific tool name you invoke through your MCP client, and the server responds with structured data you can render in your app or bot.

To configure your MCP client, reference the built backend you run locally. An example local setup uses a standard runtime where the MCP server is executed via a Node package runner. The configuration below shows how you would register the Marvel Rivals MCP server under a concise identifier and connect to it from your client.

Example tool surface you can access via your MCP client includes: listHeroes, getHeroAbilities, getHeroInfo, getHeroSkins, listSkins, listAchievements, searchAchievement, listItems, getItemsByType, listMaps, filterMaps, getPlayerProfile, searchPlayer, and getPlayerMatchHistory. Use these tools to fetch data as needed for your application or workflow.

How to install

# Prerequisites: ensure Node.js and npm are installed on your system
node -v
npm -v

# Install and run the Marvel Rivals MCP server
npx @aimaginationlab/marvel-rivals-mcp

# If you want to start it in a background process or use in automation, you can also invoke it directly via npm/npx as shown above

Configuration and usage notes

Configure your MCP client to connect to the Marvel Rivals MCP server running locally. The following local runtime example registers the server under a concise key so your client can discover and route requests to it.

{
  "mcpServers": {
    "marvel_rivals": {
      "command": "npx",
      "args": ["@aimaginationlab/marvel-rivals-mcp"]
    }
  }
}

Notes on security and maintenance

Keep the MCP server updated by using the latest release of the marvel-rivals-mcp package. If you expose this server over a network, apply standard security practices such as restricting access, auditing requests, and refreshing credentials if you integrate any authentication layers.

Available tools

listHeroes

Retrieve a complete list of Marvel Rivals heroes available in the MCP server.

getHeroAbilities

Fetch the abilities for a specific hero by identifier.

getHeroInfo

Get detailed information about a hero, including stats and background.

getHeroSkins

Obtain skins associated with a particular hero.

listSkins

List all skins available across heroes.

listAchievements

Get all achievable in-game achievements.

searchAchievement

Search for achievements by name or keyword.

listItems

Retrieve the complete catalog of in-game items.

getItemsByType

Filter items by type such as NAMEPLATE, MVP, EMOTE, or SPRAY.

listMaps

List all game maps available for matches.

filterMaps

Filter maps by type or other criteria.

getPlayerProfile

Fetch profile information for a specific player.

searchPlayer

Search for a player by username.

getPlayerMatchHistory

Obtain the match history for a given player.