Tool Reference

get_competitors

Get the list of competitors for a brand.

Parameters

Parameter Type Required Description
brandId string Yes The brand ID (UUID) or brand name (e.g., "Ace Auto Repair")
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": "get_competitors",
      "arguments": {
        "brandId": "brand_abc123"
      }
    }
  }'

Example Response

Parsed from result.content[0].text:

[
  { "name": "Meineke" },
  { "name": "Firestone" },
  { "name": "Jiffy Lube" }
]

Output Schema

Returns an array of competitor objects:

Field Type Description
name string Competitor name

Notes

  • Competitors are configured in the brand profile via the dashboard.
  • Returns an error if the brandId does not exist or does not belong to your company.