• RELATIONSHIPS
  • GROUPS
  • HISTORY
  • HUMAN

How to map character relationships with your AI

Connect SuperHero to your agent to pull character data and build relationship maps. It handles the heavy lifting of finding connections and group ties.

Ask AI about this page

Short answer

How can I map character relationships with my AI?

Your AI uses the SuperHero MCP to find specific characters and pull their existing connections or group memberships. You'll get a structured map of heroes, villains, and allies. The following breakdown shows what you'll get.

The outcomes

Where your data lands

The AI organizes the character data into these specific views.

RELATIONSHIPS

Connection maps

The AI identifies how characters interact. You get a clear list of allies, enemies, and rivals.

GROUPS

Affiliation lists

The AI groups characters by their teams or factions. This makes it easy to see who belongs where.

HISTORY

Work logs

The AI pulls specific character works to provide context for why certain relationships exist.

HUMAN

Manual review

You check the generated maps to ensure the logic holds up for your specific story or project.

The workflow

What your AI does when the data arrives.

The AI follows a logical path from finding a name to mapping a whole network.

  1. Locate characters

    The AI finds the specific hero or villain you are interested in by searching the database.

    search_characters

  2. Identify ties

    Once found, the AI looks up the specific links between that character and others.

    get_connections

  3. Contextualize ties

    The AI checks the character's history to see the specific works that define their relationships.

    get_work

  4. Organize the web

    The AI compiles all these data points into a structured relationship map for you.

    get_connections

Try it

Copy these to start.

Use these prompts to kick off the mapping process.

Starting points

These are opening lines. Swap out the character names for whoever you want to map.

SuperHero API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_E1hs0ulQpOdbr1fWpmUbVUuuCI79kPQ61iFvBQdf/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — SuperHero API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "superhero-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_E1hs0ulQpOdbr1fWpmUbVUuuCI79kPQ61iFvBQdf/mcp"
    }
  }
}
Copy into chat04

  • Find all connections for Batman and list his main allies.

  • Who are the primary villains associated with Spider-Man?

  • Show me the group affiliations for the X-Men characters.

  • Map the relationship between Joker and various Gotham heroes.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect SuperHero once, then ask.

Click the link to connect the MCP. Your credentials stay encrypted, and you can start chatting with your agent immediately.

Connect SuperHero to your AI

FAQ

How this task behaves

  • 01

    Can the AI create new characters?

    No. The AI can only search and retrieve existing character data.

  • 02

    Will the AI change character relationships?

    No. The AI only reads the data provided by the MCP; it cannot modify the database.

  • 03

    Can I export the relationship map as a file?

    The AI can format the data as text or a table for you to copy, but it cannot generate external files.

  • 04

    Does it work with any AI client?

    Yes, it works with any MCP-compatible client like Claude, Cursor, or Windsurf.

  • 05

    Can the AI tell me why two characters are enemies?

    Yes, by using the work history data to find the context behind their connections.

  • More questions about SuperHero? See everything the SuperHero Connector can do

Connect SuperHero API to Claude, Cursor, ChatGPT & more