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 '{}'