Search Markets (Market)

mdmcp-search_markets

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

Markets represent geographic or regional market segments. The id is the code (US, UK, EU) and the name carries it as a suffix — United States (US), Europe (EU). The code, the full name and the country on its own all name the same market, so any of US, United States (US) or United States is exact.

Use the returned id value when building market filters.

Every hit carries match: exact (query equals its id or name, ignoring case, accents, punctuation and spacing; a separator between two digits is kept, so 3-6 months is not 36 months; a region/code suffix on the name is ignored), lexical (text search ranked it: a typo, a partial, or the name plus or minus a word), or semantic_only (only the vector arm returned it: a nearest neighbour, not a match — verify or discard). Nothing beats semantic_only = not found. No hit is evidence of data behind the name. Rules: market_data_docs(topic="lookup_matching").

Try queries like

"United States", "US", "UK market", "Europe".

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[MarketHit]
• When query is a list: list[list[MarketHit]] 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

The payload — what you read from result.structuredContent.result. A refusal arrives on the sibling error key instead, with isError still false — see Concepts → Response shape.

[
  {
    "id": "UK",
    "name": "United Kingdom (UK)",
    "match": "exact"
  },
  {
    "id": "US",
    "name": "United States (US)",
    "match": "exact"
  }
]

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

Output schema

Describes both branches of the envelope — result on success, error on a refusal. Validate against this rather than pattern-matching the prose above; see Concepts → Response shape.

{
  "type": "object",
  "properties": {
    "result": {
      "anyOf": [
        {
          "items": {
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "match": {
                "description": "What matched, not how well. Not a score. See the tool description.",
                "enum": [
                  "exact",
                  "lexical",
                  "semantic_only"
                ],
                "type": "string"
              }
            },
            "required": [
              "id",
              "name",
              "match"
            ],
            "type": "object"
          },
          "type": "array"
        },
        {
          "items": {
            "items": {
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "match": {
                  "description": "What matched, not how well. Not a score. See the tool description.",
                  "enum": [
                    "exact",
                    "lexical",
                    "semantic_only"
                  ],
                  "type": "string"
                }
              },
              "required": [
                "id",
                "name",
                "match"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "type": "array"
        }
      ]
    },
    "error": {
      "type": "object",
      "description": "Present instead of `result` when the call was rejected. Branch on `code`; never string-match `message`.",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "invalid_input",
            "not_entitled",
            "upstream_unavailable",
            "internal"
          ]
        },
        "message": {
          "type": "string"
        },
        "field": {
          "type": "string",
          "description": "Offending parameter, when the failure is attributable to one."
        },
        "details": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "required": [
        "code",
        "message"
      ]
    }
  },
  "x-fastmcp-wrap-result": true,
  "oneOf": [
    {
      "required": [
        "result"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}