Skip to content
advardeDeveloper docs
v1.0

Import performance

Loading server catalog…. Download catalog

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

Performance imports must be enabled by the platform administrator.

Description: Import Google, Meta or other ad exports as normalized rows or CSV with optional column mapping. Monetary values are in the supplied currency, not micros. Missing metrics remain unknown. Duplicate content is idempotent.

Method: tools/call · ads_import_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.

sourceenumrequired
enum: ["google_ads","meta_ads","other"]
namestringrequired
minLength: 1maxLength: 200
currencystringrequired
pattern: "^[A-Z]{3}$"
timezonestringrequired
minLength: 1maxLength: 100
attributionstringrequired
minLength: 1maxLength: 1000
sincestringrequired
format: "date"
untilstringrequired
format: "date"
rowsarrayoptional
minItems: 1maxItems: 5000
EXPAND ROWS

Each array item

ad_idstringrequired
minLength: 1maxLength: 255
namestringoptional
minLength: 0maxLength: 1000
headlinestringoptional
minLength: 0maxLength: 1000
bodystringoptional
minLength: 0maxLength: 5000
campaignstringoptional
minLength: 0maxLength: 1000
audiencestringoptional
minLength: 0maxLength: 1000
hookstringoptional
minLength: 0maxLength: 200
offerstringoptional
minLength: 0maxLength: 200
impressionsinteger | nullrequired
minimum: 0maximum: 9007199254740991
clicksinteger | nullrequired
minimum: 0maximum: 9007199254740991
spendnumber | nullrequired
minimum: 0maximum: 9007199254740991
conversionsnumber | nulloptional
minimum: 0maximum: 9007199254740991
revenuenumber | nulloptional
minimum: 0maximum: 9007199254740991
csvstringoptional
minLength: 1maxLength: 1500000
column_mappingobjectoptional
Full JSON Schema
{
  "type": "object",
  "properties": {
    "source": {
      "enum": [
        "google_ads",
        "meta_ads",
        "other"
      ]
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "timezone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "attribution": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000
    },
    "since": {
      "type": "string",
      "format": "date"
    },
    "until": {
      "type": "string",
      "format": "date"
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ad_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255
          },
          "name": {
            "type": "string",
            "minLength": 0,
            "maxLength": 1000
          },
          "headline": {
            "type": "string",
            "minLength": 0,
            "maxLength": 1000
          },
          "body": {
            "type": "string",
            "minLength": 0,
            "maxLength": 5000
          },
          "campaign": {
            "type": "string",
            "minLength": 0,
            "maxLength": 1000
          },
          "audience": {
            "type": "string",
            "minLength": 0,
            "maxLength": 1000
          },
          "hook": {
            "type": "string",
            "minLength": 0,
            "maxLength": 200
          },
          "offer": {
            "type": "string",
            "minLength": 0,
            "maxLength": 200
          },
          "impressions": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "clicks": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "spend": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "conversions": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "revenue": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "ad_id",
          "impressions",
          "clicks",
          "spend"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 5000
    },
    "csv": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1500000
    },
    "column_mapping": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "minLength": 0,
        "maxLength": 200
      },
      "maxProperties": 20
    }
  },
  "required": [
    "source",
    "name",
    "currency",
    "timezone",
    "attribution",
    "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