Google Merchant Center · Capability

Google Merchant Center Google Merchant API

The Google Merchant API enables programmatic management of Merchant Center accounts including products, inventories, promotions, reports, conversions, and order tracking for Google Shopping.

Run with Naftiko GoogleMerchantCenterAPI

What You Can Do

GET
Listaccounts — Google Merchant Center List accounts
/accounts/v1/{parent}/accounts
POST
Insertproductinput — Google Merchant Center Insert product input
/products/v1/{parent}/productInputs
GET
Getproduct — Google Merchant Center Get product
/products/v1/{name}
POST
Insertlocalinventory — Google Merchant Center Insert local inventory
/inventories/v1/{parent}/localInventories
GET
Listpromotions — Google Merchant Center List promotions
/promotions/v1/{parent}/promotions
POST
Createpromotion — Google Merchant Center Create promotion
/promotions/v1/{parent}/promotions
POST
Searchreports — Google Merchant Center Search reports
/reports/v1/{parent}/reports:search

MCP Tools

listaccounts

Google Merchant Center List accounts

read-only idempotent
insertproductinput

Google Merchant Center Insert product input

getproduct

Google Merchant Center Get product

read-only idempotent
insertlocalinventory

Google Merchant Center Insert local inventory

listpromotions

Google Merchant Center List promotions

read-only idempotent
createpromotion

Google Merchant Center Create promotion

searchreports

Google Merchant Center Search reports

Capability Spec

google-merchant-center-capability.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: Google Merchant Center Google Merchant API
  description: The Google Merchant API enables programmatic management of Merchant Center accounts including products, inventories,
    promotions, reports, conversions, and order tracking for Google Shopping.
  tags:
  - Google
  - Merchant
  - Center
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: google-merchant-center
    baseUri: https://merchantapi.googleapis.com
    description: Google Merchant Center Google Merchant API HTTP API.
    authentication:
      type: bearer
      token: '{{GOOGLE_MERCHANT_CENTER_TOKEN}}'
    resources:
    - name: accounts-v1-parent-accounts
      path: /accounts/v1/{parent}/accounts
      operations:
      - name: listaccounts
        method: GET
        description: Google Merchant Center List accounts
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
        - name: pageSize
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: products-v1-parent-productinputs
      path: /products/v1/{parent}/productInputs
      operations:
      - name: insertproductinput
        method: POST
        description: Google Merchant Center Insert product input
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: products-v1-name
      path: /products/v1/{name}
      operations:
      - name: getproduct
        method: GET
        description: Google Merchant Center Get product
        inputParameters:
        - name: name
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: inventories-v1-parent-localinventories
      path: /inventories/v1/{parent}/localInventories
      operations:
      - name: insertlocalinventory
        method: POST
        description: Google Merchant Center Insert local inventory
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: promotions-v1-parent-promotions
      path: /promotions/v1/{parent}/promotions
      operations:
      - name: listpromotions
        method: GET
        description: Google Merchant Center List promotions
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createpromotion
        method: POST
        description: Google Merchant Center Create promotion
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: reports-v1-parent-reports-search
      path: /reports/v1/{parent}/reports:search
      operations:
      - name: searchreports
        method: POST
        description: Google Merchant Center Search reports
        inputParameters:
        - name: parent
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: google-merchant-center-rest
    description: REST adapter for Google Merchant Center Google Merchant API.
    resources:
    - path: /accounts/v1/{parent}/accounts
      name: listaccounts
      operations:
      - method: GET
        name: listaccounts
        description: Google Merchant Center List accounts
        call: google-merchant-center.listaccounts
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /products/v1/{parent}/productInputs
      name: insertproductinput
      operations:
      - method: POST
        name: insertproductinput
        description: Google Merchant Center Insert product input
        call: google-merchant-center.insertproductinput
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /products/v1/{name}
      name: getproduct
      operations:
      - method: GET
        name: getproduct
        description: Google Merchant Center Get product
        call: google-merchant-center.getproduct
        with:
          name: rest.name
        outputParameters:
        - type: object
          mapping: $.
    - path: /inventories/v1/{parent}/localInventories
      name: insertlocalinventory
      operations:
      - method: POST
        name: insertlocalinventory
        description: Google Merchant Center Insert local inventory
        call: google-merchant-center.insertlocalinventory
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /promotions/v1/{parent}/promotions
      name: listpromotions
      operations:
      - method: GET
        name: listpromotions
        description: Google Merchant Center List promotions
        call: google-merchant-center.listpromotions
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /promotions/v1/{parent}/promotions
      name: createpromotion
      operations:
      - method: POST
        name: createpromotion
        description: Google Merchant Center Create promotion
        call: google-merchant-center.createpromotion
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
    - path: /reports/v1/{parent}/reports:search
      name: searchreports
      operations:
      - method: POST
        name: searchreports
        description: Google Merchant Center Search reports
        call: google-merchant-center.searchreports
        with:
          parent: rest.parent
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: google-merchant-center-mcp
    transport: http
    description: MCP adapter for Google Merchant Center Google Merchant API for AI agent use.
    tools:
    - name: listaccounts
      description: Google Merchant Center List accounts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-merchant-center.listaccounts
      with:
        parent: tools.parent
        pageSize: tools.pageSize
        pageToken: tools.pageToken
      inputParameters:
      - name: parent
        type: string
        description: parent
        required: true
      - name: pageSize
        type: integer
        description: pageSize
      - name: pageToken
        type: string
        description: pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: insertproductinput
      description: Google Merchant Center Insert product input
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-merchant-center.insertproductinput
      with:
        parent: tools.parent
      inputParameters:
      - name: parent
        type: string
        description: parent
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getproduct
      description: Google Merchant Center Get product
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-merchant-center.getproduct
      with:
        name: tools.name
      inputParameters:
      - name: name
        type: string
        description: name
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: insertlocalinventory
      description: Google Merchant Center Insert local inventory
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-merchant-center.insertlocalinventory
      with:
        parent: tools.parent
      inputParameters:
      - name: parent
        type: string
        description: parent
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listpromotions
      description: Google Merchant Center List promotions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-merchant-center.listpromotions
      with:
        parent: tools.parent
      inputParameters:
      - name: parent
        type: string
        description: parent
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: createpromotion
      description: Google Merchant Center Create promotion
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-merchant-center.createpromotion
      with:
        parent: tools.parent
      inputParameters:
      - name: parent
        type: string
        description: parent
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: searchreports
      description: Google Merchant Center Search reports
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-merchant-center.searchreports
      with:
        parent: tools.parent
      inputParameters:
      - name: parent
        type: string
        description: parent
        required: true
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    GOOGLE_MERCHANT_CENTER_TOKEN: GOOGLE_MERCHANT_CENTER_TOKEN