Skip to content
advardeDeveloper docs
v1.0

Sync source performance

Loading server catalog…. Download catalog

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

Performance imports must be enabled by the platform administrator.

Description: Read Google or Meta ad performance and creative text for an explicit date range and save a normalized import. Never writes to Google or Meta. Google conversion definitions follow the account configuration; Meta uses the selected action and 7-day-click window.

Method: tools/call · ads_sync_source_performance

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.

connection_idstringrequired
format: "uuid"
source_account_idstringrequired
pattern: "^[0-9]{1,30}$"
login_customer_idstringoptional
pattern: "^[0-9]{1,30}$"
sincestringrequired
format: "date"
untilstringrequired
format: "date"
meta_conversion_actionstringoptional
minLength: 1maxLength: 150
Full JSON Schema
{
  "type": "object",
  "properties": {
    "connection_id": {
      "type": "string",
      "format": "uuid"
    },
    "source_account_id": {
      "type": "string",
      "pattern": "^[0-9]{1,30}$"
    },
    "login_customer_id": {
      "type": "string",
      "pattern": "^[0-9]{1,30}$"
    },
    "since": {
      "type": "string",
      "format": "date"
    },
    "until": {
      "type": "string",
      "format": "date"
    },
    "meta_conversion_action": {
      "type": "string",
      "minLength": 1,
      "maxLength": 150
    }
  },
  "required": [
    "connection_id",
    "source_account_id",
    "since",
    "until"
  ],
  "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