Search Size Groups (Market)

mdmcp-search_size_group

Find size groups to use in filter queries. Search by name, category, or gender.

Size groups define sizing systems (e.g., "US Women's Apparel", "EU Men's Shoes").

Use the returned id value when building size group filters.

Try queries like

"women's sizes", "mens shoes", "kids clothing", "UK sizing".

Parameters

Name	Type	Required	Constraints	Description
query	string | string[]	yes	—	Single query string or list of query strings for batch search.
search_limit	integer	no	default: 10 · 1–50	Maximum number of results to return (default 10, max 50). Raise it when validating or comparing many entities in one call so the list is not clipped at the default 10.

Returns

• When query is a string: list[SizeGroup]
• When query is a list: list[list[SizeGroup]] with results in same order as queries.

Try it

Loading interactive widget…

Code examples

curl

curl -s https://mcp.edited.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -H "x-api-key: $MCP_API_KEY" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mdmcp-search_size_group",
    "arguments": {
      "query": "Nike",
      "search_limit": 10
    }
  }
}'

TypeScript

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "demo", version: "1.0.0" }, { capabilities: {} });
await client.connect(
  new StreamableHTTPClientTransport(new URL("https://mcp.edited.com/mcp"), {
    requestInit: { headers: { "x-api-key": process.env.MCP_API_KEY ?? "" } },
  }),
);

const result = await client.callTool({
  name: "mdmcp-search_size_group",
  arguments: {
    "query": "Nike",
    "search_limit": 10
  },
});

Python

import os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

headers = {"x-api-key": os.environ["MCP_API_KEY"]}
async with streamablehttp_client("https://mcp.edited.com/mcp", headers=headers) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        result = await session.call_tool(
            "mdmcp-search_size_group",
            {"query": "Nike", "search_limit": 10},
        )

Example response

Parsed from result.content[0].text (the MCP envelope wraps the JSON as a TextContent block — see Concepts → Tools:

[
  {
    "id": 43,
    "name": "Womens UK",
    "category": "womens_garments",
    "gender": "adults",
    "subtitle": null,
    "unit": "womens_uk",
    "visible": true
  }
]

Input schema

{
  "type": "object",
  "properties": {
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "type": "array"
        }
      ]
    },
    "search_limit": {
      "default": 10,
      "description": "Maximum number of results to return (default 10, max 50). Raise it when validating or comparing many entities in one call so the list is not clipped at the default 10.",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "query"
  ]
}