`get_monsters`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_monsters for the schema, then POST the same URL with its arguments for the data.

Search Monster Hunter World monsters by name, species, or size class. Returns species classification, elements, ailments, and weaknesses to plan hunts.

Parameters

Name	Type	Required	Description
`name`	string	no	Filter by monster name (case-insensitive substring), e.g. “nergigante”.
`species`	string	no	Filter by species. One of: elder dragon, flying wyvern, brute wyvern, bird wyvern, fanged wyvern, piscine wyvern, fanged beast, neopteron, herbivore, wingdrake, relict, fish.
`type`	string	no	Size class: “large” (hunt targets) or “small” (ambient wildlife).
`limit`	number	no	Maximum number of monsters to return. Defaults to 20.

Example call

Arguments

{
  "limit": 10
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_monsters', {
  "limit": 10
});

More examples

{
  "limit": 20
}

Response shape

Always returns: items, count

Field	Type	Description
`items`	array
`count`	integer	Number of items returned.
`total_matched`	integer	Monsters matching the filters before the limit cut.
`total_monsters`	integer	Total monsters in the MHW database.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "Monster data from MHW database"
      }
    },
    "count": {
      "type": "integer",
      "description": "Number of items returned."
    },
    "total_matched": {
      "type": "integer",
      "description": "Monsters matching the filters before the limit cut."
    },
    "total_monsters": {
      "type": "integer",
      "description": "Total monsters in the MHW database."
    }
  },
  "required": [
    "items",
    "count"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

get_monsters