Skip to main content

API Reference

Every tool, resource, and prompt EDITED MCP exposes — auto-generated from the live server, last refreshed August 3, 2026.

Tools here are search-focused: each one resolves a fuzzy concept (a brand name, a product type, a country) into the stable slug or id that downstream filters expect. They're how an agent bridges between natural language and EDITED's structured catalogue.

Try anything live

Every tool page below has a pre-filled "Try it" widget. Click Send to call the server directly from these docs — no SDK setup required.

Tools (32)​

  • Check Retailer Coverage (Market) (mdmcp-get_retailer_coverage) — Assess data coverage — completeness AND freshness — for one or more retailers over a date range.
  • Reference Docs (Market) (mdmcp-market_data_docs) — Reference documentation for market_data_table and market_data_options_search, one topic per call: filter_fields (every filter field with type, definition, valid values, and the operator validity table), metrics (metric ids and definitions, price-unit scales, retail-term routing), group_by_fields (group-by, histogram and percentile fields), dates_and_compare (date snapping, trend rules, multi-period combining, compare semantics), text_search (name/description query syntax).
  • Vertical Access (Market) (mdmcp-market_data_entitlements) — Report which market-data verticals this account can access.
  • Query Analytics (Market) (mdmcp-market_data_table) — Query precomputed market-data analytics in any aggregation shape: snapshot, single-dimension breakdown, multi-dimension cross-tab, numeric histogram, percentile summary, time-series trend, or period-over-period comparison.
  • Search Product Options (Market) (mdmcp-market_data_options_search) — Search individual product options from the market-data service for a given date.
  • Search Brands (Market) (mdmcp-search_brands) — Find brands for the brand_slug and brand filters.
  • Search Size Groups (Market) (mdmcp-search_size_group) — Find size groups to use in filter queries.
  • Search Sizes (Market) (mdmcp-search_size_options) — Find specific sizes to use in filter queries.
  • Search Markets (Market) (mdmcp-search_markets) — Find markets to use in filter queries.
  • Search Retailers (Market) (mdmcp-search_retailers) — Find retailers to use in filter queries.
  • Search Product Categories (Market) (mdmcp-search_product_searches) — Find product categories to use in filter queries.
  • Analyze Query (Research) (researchmcp-research_analyze_query) — Analyse a research query into retrieval intent and (optionally) a date window.
  • Search Articles (Research) (researchmcp-research_article_search) — Search EDITED Research articles by meaning.
  • Search Passages (Research) (researchmcp-research_chunk_search) — Search EDITED Research articles for granular text passages.
  • Get Passage (Research) (researchmcp-research_get_chunk) — Fetch a single text chunk by its stable id.
  • Get Image (Research) (researchmcp-research_get_image) — Fetch a single image by its stable id.
  • Get Report Metadata (Research) (researchmcp-research_get_report) — Fetch full metadata for a known report_id.
  • Search Images (Research) (researchmcp-research_image_search) — Search EDITED Research articles for images by meaning.
  • List Reports (Research) (researchmcp-research_list_reports) — Browse reports newest-first by publish date, paginated via cursor.
  • Match Images to Text (Research) (researchmcp-research_match_images_to_text) — Find images that match arbitrary text by meaning.
  • Read Full Report (Research) (researchmcp-research_read_report) — Read the full article text for a known report_id.
  • Get Report Links (Research) (researchmcp-research_report_links) — Resolve report_ids to public EDITED Research article URLs.
  • Aggregate Promo Discounts (Messaging) (messagingmcp-aggregate_promos) — Compute a statistic over promo discount depth, deduped by promo_id.
  • Count Promotions (Messaging) (messagingmcp-count_promos) — Count distinct promotions matching the filters, deduped by promo_id.
  • Enrich Image Context (Messaging) (messagingmcp-enrich_with_vm) — Fetch VM (visual + page-text) context for a list of image_ids.
  • Explain Promo Methodology (Messaging) (messagingmcp-explain_promo_data) — Explain how the promo dataset was captured and what the tool fields mean.
  • Get Promotion Details (Messaging) (messagingmcp-get_promo) — Fetch a single promotion by promo_id — the campaign detail / drill-down view.
  • List Promotions (Messaging) (messagingmcp-list_promos) — List distinct promotions (one per promo_id = one campaign), newest first by start date.
  • List Retailers (Messaging) (messagingmcp-list_retailers) — List the retailers (or regions) the messaging corpus actually covers.
  • Search Visuals (Messaging) (messagingmcp-messaging_search) — Search messaging channel visuals (homepage and newsletter screenshots) by meaning.
  • Resolve Time Period (Messaging) (messagingmcp-resolve_time_period) — Resolve a natural-language time expression to {start_date, end_date}.
  • Search Promo Text (Messaging) (messagingmcp-search_promo_text) — Relevance-scored text search across promo description / conditions / categories / codes.

Resources (1)​

Prompts (3)​

  • Market data query guide (mdmcp-market_data_query_guide) — Workflow guide: resolve filter values with search_* tools, route table vs options, and read the inline result envelope incl.
  • Research orchestration guide (researchmcp-research_orchestration) — Orchestration policy for the three research_*_search tools.
  • Messaging orchestration guide (messagingmcp-messaging_orchestration) — Orchestration policy for the messaging MCP tools.