PlugsightDocs

Google Merchant Center tools

The Google Merchant Center tools in the developer API, with every argument: feed health, products and Shopping performance.

Needs: A Google Merchant Center connection (Pro and Agency). 4 tools, all read-only.

Google is still reviewing the permission this connector needs. Until it approves it, Plugsight offers Google Merchant Center to Plugsight admins only, so for most people it isn't in the Connector catalog yet and these tools don't appear. See Google Merchant Center.

These tools appear in GET /v1/tools only when the API key's MCP server includes a connection of this kind. Call each one with POST /v1/tools/\<name>, sending its arguments as a JSON object. See Calling tools for the request and response format.

These tools need a plan that includes marketing connectors (Pro or Agency). On the Free plan they don't appear, even if the connection exists.

These tools don't take an account argument. Call merchant_center_list_accounts for the Merchant Center accounts this key reaches and pass an id as merchant; leave it out when there's only one. Accounts you've hidden in Plugsight aren't listed and can't be read.

Tool What it does Kind
merchant_center_list_accounts List Merchant Center accounts Read
merchant_center_product_health Merchant Center feed health Read
merchant_center_list_products List Merchant Center products Read
merchant_center_performance Merchant Center performance Read

Every tool here only reads: none of them changes anything in Google Merchant Center, so none needs confirm.

The example requests fill in only the required arguments, with placeholder values.

merchant_center_list_accounts

List Merchant Center accounts · Read

The Google Merchant Center accounts this MCP reaches.

No arguments: send {}.

Example request:

curl -X POST https://app.plugsight.app/v1/tools/merchant_center_list_accounts \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

merchant_center_product_health

Merchant Center feed health · Read

How many products are approved, limited (disapproved in some countries), pending or disapproved, and the most common product issues with how many products each affects, examples and Google's help link.

Argument Type Required What it is
merchant string No Merchant Center account id from merchant_center_list_accounts (optional when there's only one)
top_issues integer No How many issues to list. From 1 to 100. Default 15.

Example request:

curl -X POST https://app.plugsight.app/v1/tools/merchant_center_product_health \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

merchant_center_list_products

List Merchant Center products · Read

Products with their status, price, availability, link and issues. Filter by status (e.g. disapproved) or by text in the title or offer id.

Argument Type Required What it is
merchant string No Merchant Center account id from merchant_center_list_accounts (optional when there's only one)
status string No Only products with this status. One of: approved, limited, pending, disapproved.
search string No Only products whose title or offer id contains this
limit integer No Most products to return. From 1 to 500. Default 50.

Example request:

curl -X POST https://app.plugsight.app/v1/tools/merchant_center_list_products \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

merchant_center_performance

Merchant Center performance · Read

Shopping performance (free listings and Shopping ads) from Merchant Center: impressions, clicks, click-through rate, conversions and conversion value, by product, by day or in total.

Argument Type Required What it is
merchant string No Merchant Center account id from merchant_center_list_accounts (optional when there's only one)
group_by string No product: top products by clicks; day: a trend; none: totals only. One of: product, day, none. Default "product".
limit integer No Most rows to return. From 1 to 1,000. Default 50.
date_preset string No Used when date_from/date_to aren't given. Default last_28d. One of: last_7d, last_28d, last_30d, last_90d, last_365d, this_month, last_month, this_year, last_year.
date_from string No YYYY-MM-DD, or "today", "yesterday", "NdaysAgo" (e.g. "28daysAgo")
date_to string No YYYY-MM-DD, or "today", "yesterday", "NdaysAgo" (e.g. "28daysAgo")

Example request:

curl -X POST https://app.plugsight.app/v1/tools/merchant_center_performance \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'