# 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.

> [!IMPORTANT]
> 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](https://docs.plugsight.app/connectors/google-merchant-center.md).

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](https://docs.plugsight.app/developers/calling-tools.md) 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`](#merchant_center_list_accounts) | List Merchant Center accounts | Read |
| [`merchant_center_product_health`](#merchant_center_product_health) | Merchant Center feed health | Read |
| [`merchant_center_list_products`](#merchant_center_list_products) | List Merchant Center products | Read |
| [`merchant_center_performance`](#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:

```bash
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:

```bash
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:

```bash
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:

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

## Related articles

- [Google Merchant Center](https://docs.plugsight.app/connectors/google-merchant-center.md)
- [Calling tools](https://docs.plugsight.app/developers/calling-tools.md)
- [Errors](https://docs.plugsight.app/developers/errors.md)
- [Accounts tools](https://docs.plugsight.app/developers/accounts-tools.md)

---

Web version: https://docs.plugsight.app/developers/merchant-center-tools
