Connect XYDC MCP to Your AI Agent

Use AI with XYDC MCP to discover live analysis tools and prepare category-insight resources for a confirmed market and category.

48 tools API key

Try a XYDC MCP Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill XYDC MCP

Prepare Category Research

Read the official guide before generating a category resource.

/oo XYDC MCP: Read category insight guide, then generate resource for confirmed country [country], categoryId [ID], user_task [task].

Use a Discovered Tool

Inspect tool behavior and schema before JSON invocation.

/oo XYDC MCP: List tools, inspect [tool name], then call with arguments [JSON].

Start Working with XYDC MCP

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect XYDC MCP

    Provide the XYDC MCP Token rather than a REST API Key.

    Connect XYDC MCP →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • XYDC MCP access and quota for the selected research tools.
  • Read the category workflow guide and confirm country/category before resource generation. Generic calls use live schemas and may consume quota.

XYDC MCP Tools

Use AI with XYDC MCP to discover live analysis tools and prepare category-insight resources for a confirmed market and category.

Prepare Category Research

Read the official guide before generating a category resource.

Use a Discovered Tool

Inspect tool behavior and schema before JSON invocation.

48 tools

List Tools

Discover the current XYDC MCP tools, behavior annotations, and live input schemas before choosing a tool to call.

xydc_mcp.list_tools

Call Tool

Call a current XYDC MCP tool with JSON arguments matching its live schema. Calls may consume Credits. Each successful generate_category_insight_resource call costs 500 Credits, including existing resources; reuse the returned resource and do not blindly retry generation. Connector waits at most 55 seconds for generation. A timeout does not confirm upstream cancellation or prevent charges; the result may be unknown. Do not automatically retry generation after a timeout.

xydc_mcp.call_tool

Read Category Insight Guide

Read the official XYDC category insight workflow before a category analysis: marketplace and category confirmation, resource generation, reuse, reporting periods, pagination and Credits.

xydc_mcp.read_category_insight_guide

Generate Category Insight Resource

Generate a category insight resource for a user-confirmed marketplace and category. XYDC waits up to five minutes and rebuilds failed resources internally. Each independent successful call costs 500 Credits, including existing-resource hits. Reuse resourceId for subsequent queries; do not blindly retry. Connector waits at most 55 seconds for generation. A timeout does not confirm upstream cancellation or prevent charges; the result may be unknown. Do not automatically retry generation after a timeout. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.generate_category_insight_resource

Get Asin Ad Change Trends

Get daily newly observed advertising campaigns for one ASIN. This does not establish whether existing campaigns stopped, decreased, were deleted or remain active. Use traffic trends for traffic changes.

xydc_mcp.get_asin_ad_change_trends

Get Asin Bsr Trends

Get daily BSR category-ranking trends for one ASIN. Supports US, CA, MX, BR, UK, DE, FR, ES, IT and JP; this is not keyword ranking.

xydc_mcp.get_asin_bsr_trends

Get Asin Info

Get product titles, prices, currencies, star ratings, rating counts, images and Amazon links for up to 100 ASINs sharing one marketplace.

xydc_mcp.get_asin_info

Get Asin Info Change Trends

Get daily changes to one ASIN title and main image, including current and previous values. Use get_asin_info_trends for prices, ratings and promotions.

xydc_mcp.get_asin_info_change_trends

Get Asin Info Trends

Get daily rating counts, stars, displayed/list/deal/Prime prices, coupons, promotions and subscription offers for one ASIN. Longer date ranges cost more.

xydc_mcp.get_asin_info_trends

Get Asin Keyword Count Trends

Get daily keyword counts and distributions for ASINs sharing one marketplace. Covers organic/advertising, ranking bands, head/long-tail and acquisition-rate groups. Keyword-count growth does not prove traffic growth.

xydc_mcp.get_asin_keyword_count_trends

Get Asin Keyword Rank Hourly

Get hourly rankings of one ASIN for one keyword on one day. Supports US, UK and DE; use daily trends for multiple days.

xydc_mcp.get_asin_keyword_rank_hourly

Get Asin Keyword Rank Trends

Get daily rankings of one ASIN for one keyword over a date range.

xydc_mcp.get_asin_keyword_rank_trends

Get Asin Keyword Traffic Trends

Get daily organic, advertising and placement-level traffic for one ASIN and keyword.

xydc_mcp.get_asin_keyword_traffic_trends

Get Asin Keywords

Reverse-search keywords bringing rankings and traffic to one ASIN in the latest seven-day snapshot. Use daily or monthly tools for historical dates.

xydc_mcp.get_asin_keywords

Get Asin Keywords Daily

Get historical daily reverse-search keywords, rankings and traffic for one ASIN over a date range.

xydc_mcp.get_asin_keywords_daily

Get Asin Keywords Monthly

Get historical monthly reverse-search keywords, rankings and traffic for one ASIN over a month range.

xydc_mcp.get_asin_keywords_monthly

Get Asin Order Trends

Get monthly order counts for one ASIN over an explicit month range. Use get_asin_orders_last_30_days for recent orders.

xydc_mcp.get_asin_order_trends

Get Asin Orders Last 30 Days

Get recent order counts for one or more ASINs, measured over the last 30 days.

xydc_mcp.get_asin_orders_last_30_days

Get Asin Traffic

Get the latest seven-day organic, advertising and total traffic scores and period-over-period changes for one or more ASINs.

xydc_mcp.get_asin_traffic

Get Asin Traffic Trends

Get daily organic, advertising and placement-level traffic-score trends for one ASIN.

xydc_mcp.get_asin_traffic_trends

Get Asin Traffic Trends Monthly

Get monthly organic, advertising and placement-level traffic-score trends for one ASIN.

xydc_mcp.get_asin_traffic_trends_monthly

Get Asin Traffic Trends Weekly

Get weekly organic, advertising and placement-level traffic-score trends for one ASIN. Weeks run Monday through Sunday.

xydc_mcp.get_asin_traffic_trends_weekly

Get Asin Variations

Get the parent ASIN, child ASINs and variation attributes for one ASIN.

xydc_mcp.get_asin_variations

Get Category Brand Market Size

Get category brand market-size lists and complete trends, with monthly or last-30-day periods, price bands, rankings, sorting and pagination. Costs 5 Credits per 5 returned brands. newRelease sorts by descending sales and does not filter new brands; rankingType overrides orders. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_brand_market_size

Get Category Brand Sales Trends

Get complete historical monthly sales trends and existing last-30-day summaries for specified brands; month-range filtering is unsupported. Cost: ceil((maximum historical months + 1) / 6) times requested brand count times 2 Credits. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_brand_sales_trends

Get Category Keyword Analysis

Get category keyword summary, distribution and complete trends for one calendar month and an explicit correlationType. Omit the month for the latest available keyword month. Costs 5 Credits including trends; yearly, daily and rolling periods are unsupported. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_keyword_analysis

Get Category Keywords

Get category keywords for one calendar month, with correlation, brand, range, text and pagination filters. Omit the month for the latest available keyword month. Includes full historical trends unless includeTrend=false. Costs 1 Credit per 20 keywords. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_keywords

Get Category Market Size Trends

Get complete historical monthly category sales trends across all price bands and existing last-30-day summaries. Month-range filtering is unsupported. Costs 5 Credits per 6 historical months; last-30-day summaries add no charge. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_market_size_trends

Get Category New Release Opportunity Trends

Get category new-release opportunity summary, list, full trends and periods. Costs 5 Credits per 6 trend months; lists and periods add no charge. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_new_release_opportunity_trends

Get Category New Release Ranking

Get category new-release rankings for required reportPeriod: YYYY-MM, YYYY, last30days or last12months. Set rangeFilters.streetDays explicitly: there is no default listing-age limit, so unfiltered results are not necessarily new products. Costs 5 Credits per 5 representative ASINs. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_new_release_ranking

Get Category Price Segment Trends

Get low, middle and high price-band analysis and full trends, with period prices, brands, representative ASINs, ratings and subranges. Historical trends do not contain monthly price boundaries. Costs 5 Credits per 6 distinct months across all bands. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_price_segment_trends

Get Category Primary Asins

Get representative ASINs and complete trends for a category or price band, with rankings, sorting and pagination. last12months only supports all price bands. Costs 5 Credits per 5 representative ASINs; rankingType overrides orders. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_primary_asins

Get Category Review Analysis

Get combined category star-rating and rating-count distributions and complete trends for a calendar month or the last 30 days. Costs 5 Credits per successful call. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_review_analysis

Get Category Sales Ranking

Get category sales rankings aggregated by primaryAsin for required reportPeriod: YYYY-MM, YYYY, last30days or last12months, with brand/range filters, sorting and pagination. Costs 5 Credits per 5 returned representative ASINs, rounded up. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_sales_ranking

Get Category Seasonality

Get category seasonality, peak/off seasons, sales comparisons and forecasts. Both nonseasonal and indeterminate results use isSeasonal=false with empty analysis; request failures are errors. Costs 5 Credits per successful call. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_seasonality

Get Category Surging Ranking

Get category surging-product rankings for required reportPeriod: YYYY-MM, YYYY, last30days or last12months, with growth rules, filtering and sorting. Costs 5 Credits per 5 representative ASINs. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_category_surging_ranking

Get Keyword Aba Trends

Get weekly ABA search-volume trends for up to 100 keywords and at most 52 calendar weeks. ABA weeks run Sunday through Saturday, unlike ASIN traffic weeks.

xydc_mcp.get_keyword_aba_trends

Get Keyword Advertising Replay

Replay hourly advertising placements for one keyword on one day in US, UK or DE, returning up to 24 hours of placement competition.

xydc_mcp.get_keyword_advertising_replay

Get Keyword Analysis Monthly

Get monthly ASIN competition, rankings and traffic for one keyword over a month range.

xydc_mcp.get_keyword_analysis_monthly

Get Keyword Asin Analysis

Reverse-search competing ASINs and their rankings and traffic for one keyword in the latest seven-day snapshot.

xydc_mcp.get_keyword_asin_analysis

Get Keyword Info

Get the latest weekly search volume, ABA ranking, competition difficulty and suggested bids for up to 100 keywords in one marketplace.

xydc_mcp.get_keyword_info

Get Multi Asin Keyword Comparison

Compare latest seven-day keyword coverage, rankings and traffic across up to 20 ASINs when the user requests comparison or keyword-library building. Do not silently combine independent ASIN queries.

xydc_mcp.get_multi_asin_keyword_comparison

Get Multi Asin Keyword Comparison Monthly

Compare historical monthly keyword coverage, rankings and traffic across up to 20 ASINs for comparison or keyword-library building.

xydc_mcp.get_multi_asin_keyword_comparison_monthly

Get Parent Asin Keywords

Get latest seven-day keywords across all children of one parent. Supply one child ASIN; XYDC resolves its parent. Use only for an explicitly requested parent-level analysis.

xydc_mcp.get_parent_asin_keywords

Get Parent Asin Keywords Monthly

Get historical monthly keywords across all children of one parent. Supply one child ASIN; XYDC resolves its parent. Use only for an explicitly requested parent-level analysis.

xydc_mcp.get_parent_asin_keywords_monthly

Get Primary Asin Children

Get children and complete trends for one representative primaryAsin string, with reporting periods, price bands and pagination. Costs 5 Credits per 20 child ASINs. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.get_primary_asin_children

Report Missing Xiyou Capability

Submit a missing-capability feedback event to XYDC when requested by the user. This records product feedback, not Amazon data, and should not be used for ordinary input errors. Redact sensitive information before submission.

xydc_mcp.report_missing_xiyou_capability

Search Market Insight Categories

Search Amazon categories by keyword or ASIN, returning paths, representative-ASIN counts, availability and existing translations. Free. Present candidates and obtain user confirmation before generating a category resource, even for one candidate. Read xydc_mcp.read_category_insight_guide before the first category insight task.

xydc_mcp.search_market_insight_categories

Frequently Asked Questions

Is the REST API key accepted?

Use the MCP Token specified by the XYDC MCP access guide.

Does resource generation finish every analysis step?

It generates a category-insight resource. Follow the official workflow for subsequent processing.

Should I retry resource generation after a timeout?

Do not retry automatically. Generation can still complete and consume Credits after a connector timeout. Reuse a returned resource ID for later queries instead of generating the same resource again.

Connect XYDC MCP

About XYDC MCP ↗