Accounts, assets, and brands

Resolve Superlaunch account and brand IDs before reading or changing objects. Asset IDs identify provider objects; account IDs identify Superlaunch records. The tables list arguments and common nested fields. Expand Full input schema for all fields and allowed values. Workspace and account permissions apply to every tool.

ad_accounts_list

List ad accounts the current user may read. Access: mcp:read.

Parameter	Type	Required / default	Details
`limit`	integer	`25`

Full input schema

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 25,
      "type": "integer"
    }
  },
  "type": "object"
}

ad_accounts_get

Read one authorized ad account. Access: mcp:read.

Parameter	Type	Required / default	Details
`ad_account_id`	uuid	Required	Superlaunch account UUID from `ad_accounts_list`.

Full input schema

{
  "additionalProperties": false,
  "properties": {
    "ad_account_id": {
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "ad_account_id"
  ],
  "type": "object"
}

brands_list

List brands the current user may read. Access: mcp:read.

Parameter	Type	Required / default	Details
`limit`	integer	`25`

Full input schema

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 25,
      "type": "integer"
    }
  },
  "type": "object"
}

brands_create

Create a brand profile and grant its creator write access. Optional fields include website, industry, description, markets, and languages. Assign ad accounts separately. Access: mcp:read and mcp:write.

Parameter	Type	Required / default	Details
`payload`	object	Required	Create a workspace brand; reuse request_id only for identical retries.

payload fields

Parameter	Type	Required / default	Details
`request_id`	uuid	Required	UUID for this operation; use a new UUID for changed inputs.
`name`	string	Required	minLength: `1`. maxLength: `200`. pattern: `\S`.
`website`	string or null	`null`
`industry`	string or null	`null`
`description`	string or null	`null`
`markets`	array of string	Optional	maxItems: `50`.
`languages`	array of string	Optional	maxItems: `50`.

Retries: reuse the same request_id with unchanged inputs for the same operation.

Full input schema

{
  "$defs": {
    "BrandCreate": {
      "additionalProperties": false,
      "description": "Create a workspace brand; reuse request_id only for identical retries.",
      "properties": {
        "request_id": {
          "format": "uuid",
          "type": "string"
        },
        "name": {
          "$ref": "#/$defs/BrandName"
        },
        "website": {
          "anyOf": [
            {
              "maxLength": 500,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "industry": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "description": {
          "anyOf": [
            {
              "maxLength": 10000,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "markets": {
          "items": {
            "$ref": "#/$defs/BrandLabel"
          },
          "maxItems": 50,
          "type": "array"
        },
        "languages": {
          "items": {
            "$ref": "#/$defs/BrandLabel"
          },
          "maxItems": 50,
          "type": "array"
        }
      },
      "required": [
        "request_id",
        "name"
      ],
      "type": "object"
    },
    "BrandLabel": {
      "maxLength": 100,
      "minLength": 1,
      "pattern": "\\S",
      "type": "string"
    },
    "BrandName": {
      "maxLength": 200,
      "minLength": 1,
      "pattern": "\\S",
      "type": "string"
    }
  },
  "additionalProperties": false,
  "properties": {
    "payload": {
      "$ref": "#/$defs/BrandCreate"
    }
  },
  "required": [
    "payload"
  ],
  "type": "object"
}

brands_update

Update selected profile or brand-kit fields. Omitted fields keep their values; empty lists clear markets or languages. A kit change saves a new version. Supply kit.positioning when creating the first kit. Access: mcp:read and mcp:write.

Parameter	Type	Required / default	Details
`brand_id`	uuid	Required	Brand UUID from `brands_list`.
`payload`	object	Required	Partially update a brand; reuse request_id only for identical retries.

payload fields

Parameter	Type	Required / default	Details
`request_id`	uuid	Required	UUID for this operation; use a new UUID for changed inputs.
`name`	string or null	`null`
`website`	string or null	`null`
`industry`	string or null	`null`
`description`	string or null	`null`
`markets`	array of string or null	`null`
`languages`	array of string or null	`null`
`kit`	object or null	`null`	Brand messaging, voice, colors, and typography.

Retries: reuse the same request_id with unchanged inputs for the same operation.

Full input schema

{
  "$defs": {
    "BrandKitColor": {
      "additionalProperties": false,
      "description": "One semantic color in a brand palette.",
      "properties": {
        "role": {
          "enum": [
            "primary",
            "secondary",
            "accent",
            "background",
            "text"
          ],
          "type": "string"
        },
        "name": {
          "maxLength": 80,
          "minLength": 1,
          "type": "string"
        },
        "hex": {
          "pattern": "^#[0-9A-Fa-f]{6}$",
          "type": "string"
        }
      },
      "required": [
        "role",
        "name",
        "hex"
      ],
      "type": "object"
    },
    "BrandKitPositioning": {
      "maxLength": 300,
      "minLength": 1,
      "type": "string"
    },
    "BrandKitTagline": {
      "maxLength": 160,
      "type": "string"
    },
    "BrandKitTypographyUpdate": {
      "additionalProperties": false,
      "description": "Partial primary brand typeface update; null clears a font.",
      "properties": {
        "heading_font": {
          "anyOf": [
            {
              "maxLength": 120,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "body_font": {
          "anyOf": [
            {
              "maxLength": 120,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "type": "object"
    },
    "BrandKitUpdate": {
      "additionalProperties": false,
      "description": "Partial versioned kit update; omitted fields retain their current values.",
      "properties": {
        "positioning": {
          "anyOf": [
            {
              "$ref": "#/$defs/BrandKitPositioning"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "tagline": {
          "anyOf": [
            {
              "$ref": "#/$defs/BrandKitTagline"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "colors": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/BrandKitColor"
              },
              "maxItems": 5,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "typography": {
          "anyOf": [
            {
              "$ref": "#/$defs/BrandKitTypographyUpdate"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "voice": {
          "anyOf": [
            {
              "$ref": "#/$defs/BrandKitVoiceUpdate"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "proof_points": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "maxItems": 3,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "type": "object"
    },
    "BrandKitVoiceUpdate": {
      "additionalProperties": false,
      "description": "Partial brand voice update; empty traits clear and null clears guidance.",
      "properties": {
        "traits": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "maxItems": 5,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "guidance": {
          "anyOf": [
            {
              "maxLength": 500,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "type": "object"
    },
    "BrandLabel": {
      "maxLength": 100,
      "minLength": 1,
      "pattern": "\\S",
      "type": "string"
    },
    "BrandName": {
      "maxLength": 200,
      "minLength": 1,
      "pattern": "\\S",
      "type": "string"
    },
    "BrandUpdate": {
      "additionalProperties": false,
      "description": "Partially update a brand; reuse request_id only for identical retries.",
      "properties": {
        "request_id": {
          "format": "uuid",
          "type": "string"
        },
        "name": {
          "anyOf": [
            {
              "$ref": "#/$defs/BrandName"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "website": {
          "anyOf": [
            {
              "maxLength": 500,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "industry": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "description": {
          "anyOf": [
            {
              "maxLength": 10000,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "markets": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/BrandLabel"
              },
              "maxItems": 50,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "languages": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/BrandLabel"
              },
              "maxItems": 50,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "kit": {
          "anyOf": [
            {
              "$ref": "#/$defs/BrandKitUpdate"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "request_id"
      ],
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "brand_id": {
      "format": "uuid",
      "type": "string"
    },
    "payload": {
      "$ref": "#/$defs/BrandUpdate"
    }
  },
  "required": [
    "brand_id",
    "payload"
  ],
  "type": "object"
}

brands_get

Read one authorized brand with its active structured brand kit. Access: mcp:read.

Parameter	Type	Required / default	Details
`brand_id`	uuid	Required	Brand UUID from `brands_list`.

Full input schema

{
  "additionalProperties": false,
  "properties": {
    "brand_id": {
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "brand_id"
  ],
  "type": "object"
}

assets_list

List a page of campaigns, ad sets, ads, or creatives for an account. Access: mcp:read.

Parameter	Type	Required / default	Details
`ad_account_id`	uuid	Required	Superlaunch account UUID from `ad_accounts_list`.
`level`	campaign, adset, ad, creative	Required	Asset level: campaign, ad set, ad, or creative.
`limit`	integer	`25`	minimum: `1`. maximum: `200`.
`cursor`	string or null	`null`

Full input schema

{
  "$defs": {
    "AssetCursor": {
      "anyOf": [
        {
          "pattern": "^[0-9]+$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "AssetLevel": {
      "enum": [
        "campaign",
        "adset",
        "ad",
        "creative"
      ],
      "type": "string"
    },
    "AssetLimit": {
      "maximum": 200,
      "minimum": 1,
      "type": "integer"
    }
  },
  "additionalProperties": false,
  "properties": {
    "ad_account_id": {
      "format": "uuid",
      "type": "string"
    },
    "level": {
      "$ref": "#/$defs/AssetLevel"
    },
    "limit": {
      "$ref": "#/$defs/AssetLimit",
      "default": 25
    },
    "cursor": {
      "$ref": "#/$defs/AssetCursor",
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "ad_account_id",
    "level"
  ],
  "type": "object"
}

assets_get

Read one campaign, ad set, ad, or creative from the imported account data. Access: mcp:read.

Parameter	Type	Required / default	Details
`asset_id`	string	Required	Provider object ID returned by `assets_list`.
`ad_account_id`	uuid	Required	Superlaunch account UUID from `ad_accounts_list`.

Full input schema

{
  "additionalProperties": false,
  "properties": {
    "asset_id": {
      "type": "string"
    },
    "ad_account_id": {
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "asset_id",
    "ad_account_id"
  ],
  "type": "object"
}

Start here

Workspace

Workflows

Launcher

MCP

MCP reference

Support

Accounts, assets, and brands

ad_accounts_list

ad_accounts_get

brands_list

brands_create

payload fields

brands_update

payload fields

brands_get

assets_list

assets_get

​ad_accounts_list

​ad_accounts_get

​brands_list

​brands_create

​payload fields

​brands_update

​payload fields

​brands_get

​assets_list

​assets_get

ad_accounts_list

ad_accounts_get

brands_list

brands_create

payload fields

brands_update

payload fields

brands_get

assets_list

assets_get