# Google Merchant Center

Source: https://pilot.braike.com/en/docs/regies/merchant-center

The 28 tools Pilot MCP serves for Google Merchant Center: 15 read-only, and 13 that write with the €29 plan, taken from the server.

Pilot MCP serves **15 read-only tools** for Google Merchant Center, on every plan. With the €29 plan, it also serves **9** that create or change and **4** that delete. Their names start with `merchant_center_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 15 |
| [Create and change (€29)](#modification) | 9 |
| [Delete (€29)](#suppression) | 4 |

## Other tools [#autres]

### `merchant_center_get_account` [#merchant_center_get_account]

**Google Merchant Center: Get Account** · read-only · idempotent

Returns the details of a Merchant Center account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |

### `merchant_center_get_data_source` [#merchant_center_get_data_source]

**Google Merchant Center: Get Data Source** · read-only · idempotent

Returns the details of one data source (product feed) of a Merchant Center account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `data_source_id` | `string` | yes | Data source ID. |

### `merchant_center_get_product` [#merchant_center_get_product]

**Google Merchant Center: Get Product** · read-only · idempotent

Returns the full details of a processed product (attributes + productStatus with destinationStatuses and itemLevelIssues).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product` | `string` | yes | Product name: contentLanguage\~feedLabel\~offerId (e.g. en\~US\~SKU123). |

### `merchant_center_get_product_status` [#merchant_center_get_product_status]

**Google Merchant Center: Get Product Status** · read-only · idempotent

Returns the status of a product (destinationStatuses + summary of the item-level issues). Derived from the product.productStatus field: there is no separate resource.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product` | `string` | yes | Product name: contentLanguage\~feedLabel\~offerId. |

### `merchant_center_get_promotion` [#merchant_center_get_promotion]

**Google Merchant Center: Get Promotion** · read-only · idempotent

Returns the details of one promotion of a Merchant Center account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `promotion` | `string` | yes | Promotion ID (promotion). |

### `merchant_center_list_account_issues` [#merchant_center_list_account_issues]

**Google Merchant Center: List Account Issues** · read-only · idempotent

Lists the account-level problems (account issues). Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `page_size` | `number` | no | Default: `50`. |
| `page_token` | `string` | no |   |

### `merchant_center_list_accounts` [#merchant_center_list_accounts]

**Google Merchant Center: List Accounts** · read-only · idempotent

Lists the accessible Merchant Center accounts (read-only).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page_size` | `number` | no | Maximum number of accounts (default 50). Default: `50`. |
| `page_token` | `string` | no | Pagination token from a previous call. |
| `account_id` | `string` | no | Google Merchant Center account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `merchant_center_list_data_sources` [#merchant_center_list_data_sources]

**Google Merchant Center: List Data Sources** · read-only · idempotent

Lists the data sources (product feeds) of a Merchant Center account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `page_size` | `number` | no | Default: `50`. |
| `page_token` | `string` | no |   |

### `merchant_center_list_local_inventory` [#merchant_center_list_local_inventory]

**Google Merchant Center: List Local Inventory** · read-only · idempotent

Lists the local inventories of a product.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product` | `string` | yes | Product name: contentLanguage\~feedLabel\~offerId. |
| `page_size` | `number` | no | Default: `50`. |
| `page_token` | `string` | no |   |

### `merchant_center_list_product_issues` [#merchant_center_list_product_issues]

**Google Merchant Center: List Product Issues** · read-only · idempotent

Lists the product-level problems (item-level issues) of a product, taken from product.productStatus.itemLevelIssues.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product` | `string` | yes | Product name: contentLanguage\~feedLabel\~offerId. |

### `merchant_center_list_products` [#merchant_center_list_products]

**Google Merchant Center: List Products** · read-only · idempotent

Lists the PROCESSED products of a Merchant Center account (read-only). Google derives products from the productInputs.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `page_size` | `number` | no | Maximum number of products (default 50). Default: `50`. |
| `page_token` | `string` | no | Pagination token from a previous call. |

### `merchant_center_list_promotions` [#merchant_center_list_promotions]

**Google Merchant Center: List Promotions** · read-only · idempotent

Lists the promotions of a Merchant Center account.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `page_size` | `number` | no | Default: `50`. |
| `page_token` | `string` | no |   |

### `merchant_center_list_regional_inventory` [#merchant_center_list_regional_inventory]

**Google Merchant Center: List Regional Inventory** · read-only · idempotent

Lists the regional inventories of a product.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product` | `string` | yes | Product name: contentLanguage\~feedLabel\~offerId. |
| `page_size` | `number` | no | Default: `50`. |
| `page_token` | `string` | no |   |

### `merchant_center_run_report` [#merchant_center_run_report]

**Google Merchant Center: Run Report** · read-only · idempotent

Runs a Merchant Center report via reports:search (Merchant Query Language, read-only). E.g. SELECT offer\_id, title, clicks FROM product\_view.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `query` | `string` | yes | Merchant Query Language query (SELECT ... FROM \<table\> \[WHERE ...\] \[LIMIT ...\]). |
| `page_size` | `number` | no | Maximum number of rows per page. |
| `page_token` | `string` | no | Pagination token from a previous call. |

### `merchant_center_validate_product_payload` [#merchant_center_validate_product_payload]

**Google Merchant Center: Validate Product Payload** · read-only · idempotent

Validates a product input payload on the client side (no network call) before insert/update: identity (offerId/contentLanguage/feedLabel/dataSource) + recommended attributes.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `offer_id` | `string` | no | offerId of the offer. |
| `content_language` | `string` | no | Content language (e.g. 'fr'). |
| `feed_label` | `string` | no | Feed label (e.g. 'FR'). |
| `data_source` | `string` | no | Target dataSource. |
| `attributes` | `object` | no | Product attributes to validate. |
| `account_id` | `string` | no | Google Merchant Center account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `merchant_center_create_data_source` [#merchant_center_create_data_source]

**Google Merchant Center: Create Data Source** · create or change, €29 plan · creates an object on each call

Creates a data source (product feed). Provide a dataSource in Merchant API format (displayName + a source type, e.g. primaryProductDataSource).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `data_source` | `object` | yes | Data source body (displayName + primaryProductDataSource/supplementalProductDataSource + optional fileInput). |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_fetch_data_source` [#merchant_center_fetch_data_source]

**Google Merchant Center: Fetch Data Source** · create or change, €29 plan · creates an object on each call

Immediately triggers the download of a file-type data source (:fetch).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `data_source_id` | `string` | yes | ID of the data source to refresh. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_insert_product` [#merchant_center_insert_product]

**Google Merchant Center: Insert Product** · create or change, €29 plan · creates an object on each call

Creates or updates (upsert) a product input via productInputs:insert. dataSource is REQUIRED. The processed product can take a few minutes to appear.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `data_source` | `string` | yes | Target dataSource, format accounts/\{account\}/dataSources/\{id\} or just \{id\}. |
| `offer_id` | `string` | yes | Unique identifier of the offer (offerId). |
| `content_language` | `string` | yes | Content language (ISO 639-1), e.g. 'fr'. |
| `feed_label` | `string` | yes | Feed label (often a country code), e.g. 'FR'. |
| `attributes` | `object` | no | Product attributes (title, description, link, imageLink, brand, price \{amountMicros, currencyCode\}, availability IN\_STOCK\|OUT\_OF\_STOCK\|PREORDER\|BACKORDER, condition NEW\|USED\|REFURBISHED, ...). Sent to Google under productAttributes (Merchant API v1). |
| `custom_attributes` | `object[]` | no | Additional custom attributes. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_insert_promotion` [#merchant_center_insert_promotion]

**Google Merchant Center: Insert Promotion** · create or change, €29 plan · creates an object on each call

Creates or updates (upsert) a promotion via promotions:insert. dataSource REQUIRED. Promotions have no delete and no patch.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `data_source` | `string` | yes | Target dataSource, format accounts/\{account\}/dataSources/\{id\} or just \{id\}. |
| `promotion` | `object` | yes | Promotion body (promotionId, contentLanguage, targetCountry, redemptionChannel, attributes...). |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_update_data_source` [#merchant_center_update_data_source]

**Google Merchant Center: Update Data Source** · create or change, €29 plan · creates an object on each call

Updates a data source (PATCH + updateMask). Provide only the fields to change.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `data_source_id` | `string` | yes | Data source ID. |
| `updates` | `object` | yes | Data source fields to change. |
| `update_mask` | `string` | no | Field mask (e.g. 'displayName'). Recommended. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_update_local_inventory` [#merchant_center_update_local_inventory]

**Google Merchant Center: Update Local Inventory** · create or change, €29 plan · creates an object on each call

Upserts the local inventory of a product (price/availability per store) via localInventories:insert. No dataSource required.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product` | `string` | yes | Product name: contentLanguage\~feedLabel\~offerId. |
| `store_code` | `string` | yes | Store code (storeCode). |
| `inventory` | `object` | no | Inventory fields (price, availability IN\_STOCK\|LIMITED\_AVAILABILITY\|ON\_DISPLAY\_TO\_ORDER\|OUT\_OF\_STOCK, quantity, ...). 'storeCode' is added automatically; the fields are sent under localInventoryAttributes (Merchant API v1). |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_update_product` [#merchant_center_update_product]

**Google Merchant Center: Update Product** · create or change, €29 plan · creates an object on each call

Updates a product input (PATCH productInputs/\{productinput\} + updateMask). dataSource is REQUIRED. Provide only the attributes to change.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product_input` | `string` | yes | Product input name: contentLanguage\~feedLabel\~offerId (e.g. fr\~FR\~SKU123). |
| `data_source` | `string` | yes | Target dataSource, format accounts/\{account\}/dataSources/\{id\} or just \{id\}. |
| `attributes` | `object` | no | Attributes to update (title, price, availability IN\_STOCK\|OUT\_OF\_STOCK\|..., ...). Sent to Google under productAttributes (Merchant API v1). |
| `update_mask` | `string` | no | Mask of the fields to update (e.g. 'productAttributes.title,productAttributes.price'). Recommended. A field named in the mask but absent from the body is DELETED from the product. 'attributes.x' or a bare 'x' are rewritten to 'productAttributes.x'. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_update_promotion` [#merchant_center_update_promotion]

**Google Merchant Center: Update Promotion** · create or change, €29 plan · creates an object on each call

Changes an existing promotion. The API has no patch: the tool reads the promotion, changes only the attributes passed in attributes (allowed: longTitle, promotionEffectiveTimePeriod, promotionDisplayTimePeriod, percentOff, moneyOffAmount, minimumPurchaseAmount, genericRedemptionCode, promotionUrl, promotionDestinations, limitQuantity, limitValue), keeps its identity (promotionId, contentLanguage, targetCountry, redemptionChannel) and its data source, reinserts it with promotions:insert, then reads it again. Google processes a promotion with a delay: the read-back may show the previous state.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `promotion` | `string` | yes | Promotion ID (promotion), as get\_promotion takes it. |
| `attributes` | `object` | yes | The attributes to change, and only those. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_update_regional_inventory` [#merchant_center_update_regional_inventory]

**Google Merchant Center: Update Regional Inventory** · create or change, €29 plan · creates an object on each call

Upserts the regional inventory of a product (price/availability per region) via regionalInventories:insert. No dataSource required.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product` | `string` | yes | Product name: contentLanguage\~feedLabel\~offerId. |
| `region` | `string` | yes | Region ID (region). |
| `inventory` | `object` | no | Inventory fields (price \{amountMicros, currencyCode\}, salePrice, availability IN\_STOCK\|OUT\_OF\_STOCK, ...). 'region' is added automatically; the fields are sent under regionalInventoryAttributes (Merchant API v1). |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

## Delete (€29) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `merchant_center_delete_data_source` [#merchant_center_delete_data_source]

**Google Merchant Center: Delete Data Source** · delete, €29 plan, one object at a time · creates an object on each call

Deletes a data source (DELETE). Destructive action: dry\_run=true by default.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `data_source_id` | `string` | yes | ID of the data source to delete. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_delete_local_inventory` [#merchant_center_delete_local_inventory]

**Google Merchant Center: Delete Local Inventory** · delete, €29 plan, one object at a time · creates an object on each call

Deletes the local inventory of one product for one store (store\_code) via localInventories.delete. Only that one inventory goes; the product stays.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product` | `string` | yes | Product name: contentLanguage\~feedLabel\~offerId. |
| `store_code` | `string` | yes | Store code (storeCode). |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_delete_product` [#merchant_center_delete_product]

**Google Merchant Center: Delete Product** · delete, €29 plan, one object at a time · creates an object on each call

Deletes a product input (DELETE productInputs/\{productinput\}). dataSource REQUIRED. Destructive action: dry\_run=true by default.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product_input` | `string` | yes | Product input name: contentLanguage\~feedLabel\~offerId. |
| `data_source` | `string` | yes | dataSource of the product input, format accounts/\{account\}/dataSources/\{id\} or \{id\}. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `merchant_center_delete_regional_inventory` [#merchant_center_delete_regional_inventory]

**Google Merchant Center: Delete Regional Inventory** · delete, €29 plan, one object at a time · creates an object on each call

Deletes the regional inventory of one product for one region (region) via regionalInventories.delete. Only that one inventory goes; the product stays.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | `string` | yes | Merchant Center account ID (or 'accounts/\{id\}'). |
| `product` | `string` | yes | Product name: contentLanguage\~feedLabel\~offerId. |
| `region` | `string` | yes | Region ID (region). |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
