Skip to content
advardeDeveloper docs
v1.0

Build variations

Loading server catalog…. Download catalog

POSThttps://app.advarde.com/mcp
Read

Available subject to your connection’s permissions.

Description: Combine explicitly supplied headlines, bodies, image URLs and landing URLs. Literal combinations only; no generated copy. Rejects more than 100 combinations.

Method: tools/call · ads_build_variations

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: Read access to the relevant workspace and account.

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.

titlesarrayrequired
minItems: 1maxItems: 100
EXPAND TITLES

Each array item

{
  "type": "string",
  "minLength": 3,
  "maxLength": 50
}
bodiesarrayrequired
minItems: 1maxItems: 100
EXPAND BODIES

Each array item

{
  "type": "string",
  "minLength": 0,
  "maxLength": 100
}
image_urlsarrayrequired
minItems: 1maxItems: 20
EXPAND IMAGE_URLS

Each array item

{
  "type": "string",
  "format": "uri",
  "pattern": "^https://",
  "maxLength": 2048
}
target_urlsarrayrequired
minItems: 1maxItems: 20
EXPAND TARGET_URLS

Each array item

{
  "type": "string",
  "format": "uri",
  "pattern": "^https://",
  "maxLength": 2048
}
Full JSON Schema
{
  "type": "object",
  "properties": {
    "titles": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 3,
        "maxLength": 50
      },
      "minItems": 1,
      "maxItems": 100
    },
    "bodies": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 100
      },
      "minItems": 1,
      "maxItems": 100
    },
    "image_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "pattern": "^https://",
        "maxLength": 2048
      },
      "minItems": 1,
      "maxItems": 20
    },
    "target_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "pattern": "^https://",
        "maxLength": 2048
      },
      "minItems": 1,
      "maxItems": 20
    }
  },
  "required": [
    "titles",
    "bodies",
    "image_urls",
    "target_urls"
  ],
  "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.

Advarde MCP API v1.0