PilotMCP
Platforms and tools

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

Other tools

merchant_center_get_account

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

Returns the details of a Merchant Center account.

ParameterTypeRequiredDescription
accountstringyesMerchant 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
data_source_idstringyesData 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).

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
productstringyesProduct 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
productstringyesProduct 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
promotionstringyesPromotion 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
page_sizenumbernoDefault: 50.
page_tokenstringno

merchant_center_list_accounts

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

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

ParameterTypeRequiredDescription
page_sizenumbernoMaximum number of accounts (default 50). Default: 50.
page_tokenstringnoPagination token from a previous call.
account_idstringnoGoogle 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
page_sizenumbernoDefault: 50.
page_tokenstringno

merchant_center_list_local_inventory

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

Lists the local inventories of a product.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
productstringyesProduct name: contentLanguage~feedLabel~offerId.
page_sizenumbernoDefault: 50.
page_tokenstringno

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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
productstringyesProduct 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
page_sizenumbernoMaximum number of products (default 50). Default: 50.
page_tokenstringnoPagination 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
page_sizenumbernoDefault: 50.
page_tokenstringno

merchant_center_list_regional_inventory

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

Lists the regional inventories of a product.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
productstringyesProduct name: contentLanguage~feedLabel~offerId.
page_sizenumbernoDefault: 50.
page_tokenstringno

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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
querystringyesMerchant Query Language query (SELECT ... FROM <table> [WHERE ...] [LIMIT ...]).
page_sizenumbernoMaximum number of rows per page.
page_tokenstringnoPagination 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.

ParameterTypeRequiredDescription
offer_idstringnoofferId of the offer.
content_languagestringnoContent language (e.g. 'fr').
feed_labelstringnoFeed label (e.g. 'FR').
data_sourcestringnoTarget dataSource.
attributesobjectnoProduct attributes to validate.
account_idstringnoGoogle 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).

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
data_sourceobjectyesData source body (displayName + primaryProductDataSource/supplementalProductDataSource + optional fileInput).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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).

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
data_source_idstringyesID of the data source to refresh.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
data_sourcestringyesTarget dataSource, format accounts/{account}/dataSources/{id} or just {id}.
offer_idstringyesUnique identifier of the offer (offerId).
content_languagestringyesContent language (ISO 639-1), e.g. 'fr'.
feed_labelstringyesFeed label (often a country code), e.g. 'FR'.
attributesobjectnoProduct 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_attributesobject[]noAdditional custom attributes.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
data_sourcestringyesTarget dataSource, format accounts/{account}/dataSources/{id} or just {id}.
promotionobjectyesPromotion body (promotionId, contentLanguage, targetCountry, redemptionChannel, attributes...).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
data_source_idstringyesData source ID.
updatesobjectyesData source fields to change.
update_maskstringnoField mask (e.g. 'displayName'). Recommended.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
productstringyesProduct name: contentLanguage~feedLabel~offerId.
store_codestringyesStore code (storeCode).
inventoryobjectnoInventory 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_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
product_inputstringyesProduct input name: contentLanguage~feedLabel~offerId (e.g. fr~FR~SKU123).
data_sourcestringyesTarget dataSource, format accounts/{account}/dataSources/{id} or just {id}.
attributesobjectnoAttributes to update (title, price, availability IN_STOCK|OUT_OF_STOCK|..., ...). Sent to Google under productAttributes (Merchant API v1).
update_maskstringnoMask 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_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
promotionstringyesPromotion ID (promotion), as get_promotion takes it.
attributesobjectyesThe attributes to change, and only those.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
productstringyesProduct name: contentLanguage~feedLabel~offerId.
regionstringyesRegion ID (region).
inventoryobjectnoInventory 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_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
data_source_idstringyesID of the data source to delete.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
productstringyesProduct name: contentLanguage~feedLabel~offerId.
store_codestringyesStore code (storeCode).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
product_inputstringyesProduct input name: contentLanguage~feedLabel~offerId.
data_sourcestringyesdataSource of the product input, format accounts/{account}/dataSources/{id} or {id}.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
accountstringyesMerchant Center account ID (or 'accounts/{id}').
productstringyesProduct name: contentLanguage~feedLabel~offerId.
regionstringyesRegion ID (region).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

On this page