Patch product feed products

Loading server catalog…. Download catalog

POSThttps://app.advarde.com/mcp

Prepare change

Upstream account eligibility and feature access may also apply.

Description: Prepare a reviewable change: Update product availability and prices for an authenticated ad account feed.. Returns a change_id; call ads_apply_change to execute after approval. Some features need Ads account enablement.

Method: tools/call · ads_patch_product_feed_products

Output: Tool data is returned in result.structuredContent and as JSON text in result.content. Inspect result.isError before using the result. Individual output fields depend on the operation.

Access: Requires the applicable write scopes, workspace role, and account permissions.

Upstream operation: PATCH /feeds/{feed_id}/products. Call this through the MCP tool above.

Review before applying

This tool prepares a proposal. Review the exact payload and obtain authorization before calling ads_apply_change. Preparation does not mean the upstream change has been applied.

Authentication

Use an MCP access token from MCP connections, or connect through OAuth. Send your token in the Authorization: Bearer header.

For full protocol initialization and tool discovery, use an MCP client. These examples show individual JSON-RPC requests.

Tool arguments

Send these fields inside params.arguments. The tool name is sent as params.name.

account_idstringrequired

Workspace-owned Advarde connection ID from ads_list_accounts.

format: "uuid"

feed_idstringrequired

bodyobjectrequired

additionalProperties: false

EXPAND BODY

productsarrayrequired

minItems: 1

EXPAND PRODUCTS

Each array item

idstringrequired

minLength: 1

variantsarrayrequired

minItems: 1

EXPAND VARIANTS

Each array item

idstringrequired

minLength: 1

titlestringoptional

priceobjectoptional

additionalProperties: false

EXPAND PRICE

amountintegerrequired

minimum: 0

currencystringrequired

minLength: 3maxLength: 3

availabilityobjectoptional

additionalProperties: false

EXPAND AVAILABILITY

availablebooleanoptional

statusstringoptional

Full JSON Schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "format": "uuid",
      "description": "Workspace-owned Advarde connection ID from ads_list_accounts."
    },
    "feed_id": {
      "type": "string"
    },
    "body": {
      "properties": {
        "products": {
          "items": {
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "variants": {
                "items": {
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1
                    },
                    "title": {
                      "type": "string"
                    },
                    "price": {
                      "properties": {
                        "amount": {
                          "type": "integer",
                          "minimum": 0
                        },
                        "currency": {
                          "type": "string",
                          "maxLength": 3,
                          "minLength": 3
                        }
                      },
                      "type": "object",
                      "required": [
                        "amount",
                        "currency"
                      ],
                      "x-openai-class-name": "sofa.api.params.product_feeds.ProductFeedDeltaPriceBody",
                      "additionalProperties": false
                    },
                    "availability": {
                      "properties": {
                        "available": {
                          "type": "boolean"
                        },
                        "status": {
                          "type": "string"
                        }
                      },
                      "type": "object",
                      "required": [],
                      "x-openai-class-name": "sofa.api.params.product_feeds.ProductFeedDeltaAvailabilityBody",
                      "additionalProperties": false
                    }
                  },
                  "type": "object",
                  "required": [
                    "id"
                  ],
                  "x-openai-class-name": "sofa.api.params.product_feeds.ProductFeedDeltaVariantBody",
                  "additionalProperties": false
                },
                "type": "array",
                "minItems": 1
              }
            },
            "type": "object",
            "required": [
              "id",
              "variants"
            ],
            "x-openai-class-name": "sofa.api.params.product_feeds.ProductFeedDeltaProductBody",
            "additionalProperties": false
          },
          "type": "array",
          "minItems": 1
        }
      },
      "type": "object",
      "required": [
        "products"
      ],
      "x-openai-class-name": "sofa.api.params.product_feeds.PatchProductFeedProductsBody",
      "additionalProperties": false
    }
  },
  "required": [
    "account_id",
    "feed_id",
    "body"
  ],
  "additionalProperties": false
}

Responses

200Successful protocol response

Inspect result.isError for tool-level failures, even when the HTTP status is 200.

202Notification accepted

MCP notifications return no JSON-RPC response body.

400Invalid request

Check the JSON-RPC envelope, parameters, and protocol version.

406Not acceptable

Accept must include application/json and text/event-stream.

429Rate limited

Wait for the Retry-After interval before making another request.

401Unauthorized

A valid, unexpired MCP bearer token is required.

403Access denied

Your connection needs access to this workspace and the requested operation.