Save marketing item

Loading server catalog…. Download catalog

POSThttps://app.advarde.com/mcp

Write

Available subject to your connection’s permissions.

Description: Save supplied content, without generating text. Updates require the current revision. Changes are local to Advarde and do not publish ads. Fetch schemas via tool discovery.

Method: tools/call · ads_save_marketing_item

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.

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.

item_idstringoptional

format: "uuid"

expected_revisionintegeroptional

minimum: 1

kindenumrequired

enum: ["brand","brief","playbook","inspiration","batch","creative"]

namestringrequired

minLength: 1maxLength: 200

collectionstringoptional

minLength: 0maxLength: 200

tagsarrayoptional

minItems: 0maxItems: 30

EXPAND TAGS

Each array item

{
  "type": "string",
  "minLength": 1,
  "maxLength": 100
}

dataschemarequired

EXPAND DATA

anyOf · schema 1

voicestringrequired

minLength: 0maxLength: 5000

audiencestringrequired

minLength: 0maxLength: 5000

approved_claimsstringrequired

minLength: 0maxLength: 5000

restrictionsstringrequired

minLength: 0maxLength: 5000

websitestringoptional

format: "uri"maxLength: 2048pattern: "^https://"

{
  "type": "object",
  "properties": {
    "voice": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "audience": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "approved_claims": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "restrictions": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "website": {
      "type": "string",
      "format": "uri",
      "pattern": "^https://",
      "maxLength": 2048
    }
  },
  "required": [
    "voice",
    "audience",
    "approved_claims",
    "restrictions"
  ],
  "additionalProperties": false
}

anyOf · schema 2

productstringrequired

minLength: 0maxLength: 5000

audiencestringrequired

minLength: 0maxLength: 5000

offerstringrequired

minLength: 0maxLength: 5000

objectivestringrequired

minLength: 0maxLength: 5000

landing_pagestringrequired

format: "uri"maxLength: 2048pattern: "^https://"

constraintsstringrequired

minLength: 0maxLength: 5000

reference_idsarrayoptional

minItems: 0maxItems: 50

EXPAND REFERENCE_IDS

Each array item

{
  "type": "string",
  "format": "uuid"
}

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "audience": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "offer": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "objective": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "landing_page": {
      "type": "string",
      "format": "uri",
      "pattern": "^https://",
      "maxLength": 2048
    },
    "constraints": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "reference_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "minItems": 0,
      "maxItems": 50
    }
  },
  "required": [
    "product",
    "audience",
    "offer",
    "objective",
    "landing_page",
    "constraints"
  ],
  "additionalProperties": false
}

anyOf · schema 3

guidancestringrequired

minLength: 1maxLength: 20000

evidenceenumrequired

enum: ["general_guidance","account_results","hypothesis"]

source_urlstringoptional

format: "uri"maxLength: 2048pattern: "^https://"

{
  "type": "object",
  "properties": {
    "guidance": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000
    },
    "evidence": {
      "enum": [
        "general_guidance",
        "account_results",
        "hypothesis"
      ]
    },
    "source_url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https://",
      "maxLength": 2048
    }
  },
  "required": [
    "guidance",
    "evidence"
  ],
  "additionalProperties": false
}

anyOf · schema 4

brandstringrequired

minLength: 1maxLength: 200

industrystringoptional

minLength: 0maxLength: 200

formatstringoptional

minLength: 0maxLength: 100

hookstringoptional

minLength: 0maxLength: 500

offerstringoptional

minLength: 0maxLength: 500

copystringrequired

minLength: 0maxLength: 5000

source_urlstringrequired

format: "uri"maxLength: 2048pattern: "^https://"

observed_atstringrequired

format: "date-time"

statusenumrequired

enum: ["observed","no_longer_observed"]

notesstringoptional

minLength: 0maxLength: 5000

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "industry": {
      "type": "string",
      "minLength": 0,
      "maxLength": 200
    },
    "format": {
      "type": "string",
      "minLength": 0,
      "maxLength": 100
    },
    "hook": {
      "type": "string",
      "minLength": 0,
      "maxLength": 500
    },
    "offer": {
      "type": "string",
      "minLength": 0,
      "maxLength": 500
    },
    "copy": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    },
    "source_url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https://",
      "maxLength": 2048
    },
    "observed_at": {
      "type": "string",
      "format": "date-time"
    },
    "status": {
      "enum": [
        "observed",
        "no_longer_observed"
      ]
    },
    "notes": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    }
  },
  "required": [
    "brand",
    "source_url",
    "observed_at",
    "status",
    "copy"
  ],
  "additionalProperties": false
}

anyOf · schema 5

brief_idstringoptional

format: "uuid"

variantsarrayrequired

minItems: 1maxItems: 100

EXPAND VARIANTS

Each array item

titlestringrequired

minLength: 3maxLength: 50

bodystringrequired

minLength: 0maxLength: 100

target_urlstringrequired

format: "uri"maxLength: 2048pattern: "^https://"

source_image_urlstringrequired

format: "uri"maxLength: 2048pattern: "^https://"

hookstringoptional

minLength: 0maxLength: 200

offerstringoptional

minLength: 0maxLength: 200

{
  "type": "object",
  "properties": {
    "brief_id": {
      "type": "string",
      "format": "uuid"
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 50
          },
          "body": {
            "type": "string",
            "minLength": 0,
            "maxLength": 100
          },
          "target_url": {
            "type": "string",
            "format": "uri",
            "pattern": "^https://",
            "maxLength": 2048
          },
          "source_image_url": {
            "type": "string",
            "format": "uri",
            "pattern": "^https://",
            "maxLength": 2048
          },
          "hook": {
            "type": "string",
            "minLength": 0,
            "maxLength": 200
          },
          "offer": {
            "type": "string",
            "minLength": 0,
            "maxLength": 200
          }
        },
        "required": [
          "title",
          "body",
          "target_url",
          "source_image_url"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 100
    }
  },
  "required": [
    "variants"
  ],
  "additionalProperties": false
}

anyOf · schema 6

account_idstringrequired

format: "uuid"

ad_idstringrequired

minLength: 1maxLength: 255

hookstringrequired

minLength: 0maxLength: 200

offerstringrequired

minLength: 0maxLength: 200

brief_idstringoptional

format: "uuid"

notesstringoptional

minLength: 0maxLength: 5000

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "format": "uuid"
    },
    "ad_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "hook": {
      "type": "string",
      "minLength": 0,
      "maxLength": 200
    },
    "offer": {
      "type": "string",
      "minLength": 0,
      "maxLength": 200
    },
    "brief_id": {
      "type": "string",
      "format": "uuid"
    },
    "notes": {
      "type": "string",
      "minLength": 0,
      "maxLength": 5000
    }
  },
  "required": [
    "account_id",
    "ad_id",
    "hook",
    "offer"
  ],
  "additionalProperties": false
}

Full JSON Schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "format": "uuid"
    },
    "expected_revision": {
      "type": "integer",
      "minimum": 1
    },
    "kind": {
      "enum": [
        "brand",
        "brief",
        "playbook",
        "inspiration",
        "batch",
        "creative"
      ]
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "collection": {
      "type": "string",
      "minLength": 0,
      "maxLength": 200
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "minItems": 0,
      "maxItems": 30
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "voice": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "audience": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "approved_claims": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "restrictions": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "website": {
              "type": "string",
              "format": "uri",
              "pattern": "^https://",
              "maxLength": 2048
            }
          },
          "required": [
            "voice",
            "audience",
            "approved_claims",
            "restrictions"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "product": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "audience": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "offer": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "objective": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "landing_page": {
              "type": "string",
              "format": "uri",
              "pattern": "^https://",
              "maxLength": 2048
            },
            "constraints": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "reference_ids": {
              "type": "array",
              "items": {
                "type": "string",
                "format": "uuid"
              },
              "minItems": 0,
              "maxItems": 50
            }
          },
          "required": [
            "product",
            "audience",
            "offer",
            "objective",
            "landing_page",
            "constraints"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "guidance": {
              "type": "string",
              "minLength": 1,
              "maxLength": 20000
            },
            "evidence": {
              "enum": [
                "general_guidance",
                "account_results",
                "hypothesis"
              ]
            },
            "source_url": {
              "type": "string",
              "format": "uri",
              "pattern": "^https://",
              "maxLength": 2048
            }
          },
          "required": [
            "guidance",
            "evidence"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "brand": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "industry": {
              "type": "string",
              "minLength": 0,
              "maxLength": 200
            },
            "format": {
              "type": "string",
              "minLength": 0,
              "maxLength": 100
            },
            "hook": {
              "type": "string",
              "minLength": 0,
              "maxLength": 500
            },
            "offer": {
              "type": "string",
              "minLength": 0,
              "maxLength": 500
            },
            "copy": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            },
            "source_url": {
              "type": "string",
              "format": "uri",
              "pattern": "^https://",
              "maxLength": 2048
            },
            "observed_at": {
              "type": "string",
              "format": "date-time"
            },
            "status": {
              "enum": [
                "observed",
                "no_longer_observed"
              ]
            },
            "notes": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            }
          },
          "required": [
            "brand",
            "source_url",
            "observed_at",
            "status",
            "copy"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "brief_id": {
              "type": "string",
              "format": "uuid"
            },
            "variants": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 50
                  },
                  "body": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 100
                  },
                  "target_url": {
                    "type": "string",
                    "format": "uri",
                    "pattern": "^https://",
                    "maxLength": 2048
                  },
                  "source_image_url": {
                    "type": "string",
                    "format": "uri",
                    "pattern": "^https://",
                    "maxLength": 2048
                  },
                  "hook": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 200
                  },
                  "offer": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 200
                  }
                },
                "required": [
                  "title",
                  "body",
                  "target_url",
                  "source_image_url"
                ],
                "additionalProperties": false
              },
              "minItems": 1,
              "maxItems": 100
            }
          },
          "required": [
            "variants"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "account_id": {
              "type": "string",
              "format": "uuid"
            },
            "ad_id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 255
            },
            "hook": {
              "type": "string",
              "minLength": 0,
              "maxLength": 200
            },
            "offer": {
              "type": "string",
              "minLength": 0,
              "maxLength": 200
            },
            "brief_id": {
              "type": "string",
              "format": "uuid"
            },
            "notes": {
              "type": "string",
              "minLength": 0,
              "maxLength": 5000
            }
          },
          "required": [
            "account_id",
            "ad_id",
            "hook",
            "offer"
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "required": [
    "kind",
    "name",
    "data"
  ],
  "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.