Search Sizes (Market)

mdmcp-search_size_options

Find specific sizes to use in filter queries. Search by size name or category.

Size options are individual sizes within a size group (e.g., "M", "42", "XL").

Use the returned id value when building size filters.

Try queries like

"medium", "size 10", "XL", "32 waist", "large".

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[SizeOption]
• When query is a list: list[list[SizeOption]] 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_options",
    "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_options",
  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_options",
            {"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": 901,
    "group_id": 43,
    "name": "12",
    "subtitle": null,
    "tags": "uk_size_12_equivalent",
    "tags_women": null,
    "visible": true,
    "group": {
      "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"
  ]
}