`get_hero`

Pack: superhero · Endpoint: https://gateway.pipeworx.io/superhero/mcp

Get full data for a superhero by their numeric ID, including powerstats, biography, appearance, and images.

Parameters

Name	Type	Required	Description
`id`	number	yes	Numeric superhero ID (1–731)

Example call

Arguments

{
  "id": 1
}

curl

curl -X POST https://gateway.pipeworx.io/superhero/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_hero","arguments":{"id":1}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_hero', {
  "id": 1
});

More examples

{
  "id": 100
}

Response shape

Always returns: id, name, slug, powerstats, appearance, biography, work, connections, images

Field	Type	Description
`id`	number	Numeric superhero ID
`name`	string	Superhero name
`slug`	string	URL-friendly slug identifier
`powerstats`	object	Power statistics
`appearance`	object	Physical appearance details
`biography`	object	Biography information
`work`	object	Work and occupation details
`connections`	object	Connections and relationships
`images`	object	Character images in multiple sizes

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Numeric superhero ID"
    },
    "name": {
      "type": "string",
      "description": "Superhero name"
    },
    "slug": {
      "type": "string",
      "description": "URL-friendly slug identifier"
    },
    "powerstats": {
      "type": "object",
      "description": "Power statistics",
      "properties": {
        "intelligence": {
          "type": [
            "number",
            "null"
          ],
          "description": "Intelligence stat (0-100 or null)"
        },
        "strength": {
          "type": [
            "number",
            "null"
          ],
          "description": "Strength stat (0-100 or null)"
        },
        "speed": {
          "type": [
            "number",
            "null"
          ],
          "description": "Speed stat (0-100 or null)"
        },
        "durability": {
          "type": [
            "number",
            "null"
          ],
          "description": "Durability stat (0-100 or null)"
        },
        "power": {
          "type": [
            "number",
            "null"
          ],
          "description": "Power stat (0-100 or null)"
        },
        "combat": {
          "type": [
            "number",
            "null"
          ],
          "description": "Combat stat (0-100 or null)"
        }
      }
    },
    "appearance": {
      "type": "object",
      "description": "Physical appearance details",
      "properties": {
        "gender": {
          "type": "string",
          "description": "Gender"
        },
        "race": {
          "type": [
            "string",
            "null"
          ],
          "description": "Race or species"
        },
        "height": {
          "type": "array",
          "description": "Height in different units",
          "items": {
            "type": "string"
          }
        },
        "weight": {
          "type": "array",
          "description": "Weight in different units",
          "items": {
            "type": "string"
          }
        },
        "eyeColor": {
          "type": "string",
          "description": "Eye color"
        },
        "hairColor": {
          "type": "string",
          "description": "Hair color"
        }
      }
    },
    "biography": {
      "type": "object",
      "description": "Biography information",
      "properties": {
        "fullName": {
          "type": "string",
          "description": "Full legal name"
        },
        "alterEgos": {
          "type": "string",
          "description": "Alternative identities"
        },
        "aliases": {
          "type": "array",
          "description": "List of aliases",
          "items": {
            "type": "string"
          }
        },
        "placeOfBirth": {
          "type": "string",
          "description": "Birthplace"
        },
        "firstAppearance": {
          "type": "string",
          "description": "First appearance in comics"
        },
        "publisher": {
          "type": "string",
          "description": "Publisher (Marvel, DC, etc.)"
        },
        "alignment": {
          "type": "string",
          "description": "Moral alignment (good, bad, neutral)"
        }
      }
    },
    "work": {
      "type": "object",
      "description": "Work and occupation details",
      "properties": {
        "occupation": {
          "type": "string",
          "description": "Primary occupation"
        },
        "base": {
          "type": "string",
          "description": "Base of operations"
        }
      }
    },
    "connections": {
      "type": "object",
      "description": "Connections and relationships",
      "properties": {
        "groupAffiliation": {
          "type": "string",
          "description": "Team or group affiliations"
        },
        "relatives": {
          "type": "string",
          "description": "Known relatives"
        }
      }
    },
    "images": {
      "type": "object",
      "description": "Character images in multiple sizes",
      "properties": {
        "xs": {
          "type": "string",
          "description": "Extra small image URL"
        },
        "sm": {
          "type": "string",
          "description": "Small image URL"
        },
        "md": {
          "type": "string",
          "description": "Medium image URL"
        },
        "lg": {
          "type": "string",
          "description": "Large image URL"
        }
      }
    }
  },
  "required": [
    "id",
    "name",
    "slug",
    "powerstats",
    "appearance",
    "biography",
    "work",
    "connections",
    "images"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "superhero": {
      "url": "https://gateway.pipeworx.io/superhero/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_hero