Tool Reference

list_brand_profiles

List all brand profiles for your company.

List all brand profiles for your company. Use this first to discover your brandId values, which are required by most other tools.

Parameters

This tool takes no user-supplied parameters.

Parameter Type Required Description
companyId string Auto-injected Injected from your API key. Do not pass this.

Example Request

curl -X POST https://socialcrm.com/api/mcp-app \
  -H "Authorization: Bearer sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/call",
    "params": {
      "name": "list_brand_profiles",
      "arguments": {}
    }
  }'

Example Response

Parsed from result.content[0].text:

[
  {
    "id": "brand_abc123",
    "brandName": "Ace Auto Repair",
    "brandDescription": "Family-owned auto repair shop serving the Dallas-Fort Worth area since 1998.",
    "industry": "Automotive Repair",
    "websiteUrl": "https://aceautorepair.com",
    "competitors": ["Meineke", "Firestone", "Jiffy Lube"],
    "keywords": ["auto repair", "oil change", "brake service", "DFW"],
    "targetAudience": "Vehicle owners in the Dallas-Fort Worth metropolitan area",
    "brandVoice": "Friendly, trustworthy, family-oriented"
  }
]

Output Schema

Returns an array of brand profile objects:

Field Type Description
id string Brand profile UUID — use this as brandId in other tools
brandName string Brand display name
brandDescription string Brand description
industry string Industry category
websiteUrl string Primary website URL
competitors string[] List of competitor names
keywords string[] Target keywords
targetAudience string Target audience description
brandVoice string Brand voice/tone description

Notes

  • Returns all brands under your company account.
  • The id field in each result is the brandId you need for tools like get_brand_profile, get_platform_metrics, get_brand_mentions, etc.
  • Call this first if you don't already know your brand IDs.