Search Markets (Market)

mdmcp-search_markets

Find markets to use in filter queries. Search by market name.

Markets represent geographic or regional market segments (e.g., "US", "UK", "Europe").

Use the returned id value when building market filters.

Try queries like

"United States", "UK market", "Europe", "Asia Pacific".

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[Market]
• When query is a list: list[list[Market]] 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_markets",
    "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_markets",
  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_markets",
            {"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": "UK",
    "name": "United Kingdom (UK)"
  },
  {
    "id": "US",
    "name": "United States (US)"
  }
]

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"
  ]
}