Google 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_.
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.
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.
Tool families
| Family | Tools |
|---|---|
| Other tools | 15 |
| Create and change (€29) | 9 |
| Delete (€29) | 4 |
Other tools
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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)
Served with the €29 plan.
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
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
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
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
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
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
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
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
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)
Served with the €29 plan. A deletion targets one object at a time.
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
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
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
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). |