lookup_brand_score | Pendium MCP Docs | Pendium.ai
Pendium MCP Docs

lookup_brand_score

Look up any brand's public AI visibility score from the Pendium Brand Index — no API key required.

Look up a brand's public AI visibility score from the Pendium Brand Index. This is the only tool that works without an API key. Search by URL, brand name, or slug.

Authentication: Not required (public)

Parameters

Provide at least one of these:

ParameterTypeRequiredDescription
urlstringAt least one requiredWebsite URL to look up (e.g., https://example.com).
namestringAt least one requiredBrand name to search for (e.g., "Pendium").
slugstringAt least one requiredBrand Index slug (e.g., "pendium"). Most precise lookup.

Resolution order

  • slug: Direct lookup by Brand Index slug. Fastest and most precise.
  • url: Extracts the domain and matches against known brand websites.
  • name: Fuzzy search by brand name. Returns an error if multiple brands match — use slug to disambiguate.

Response: brand with scan data

{
  "brand": {
    "slug": "pendium",
    "name": "Pendium",
    "website": "https://pendium.ai"
  },
  "overallScore": 82,
  "visibilityLevel": "Good",
  "scanDate": "2026-03-19T08:00:00Z",
  "personas": [...],
  "queries": [...],
  "competitors": [...],
  "brandMentionCount": 24,
  "summary": "Pendium is consistently mentioned across AI platforms...",
  "insights": {
    "strengths": [...],
    "gaps": [...],
    "opportunities": [...]
  },
  "platformScores": [...],
  "topics": [
    { "goalId": "core-product", "mentionRate": 85, "queryCount": 12 }
  ],
  "scanStats": { "queryCount": 30, "llmCallCount": 120 },
  "reportUrl": "https://pendium.ai/r/abc123",
  "brandIndexUrl": "https://pendium.ai/brands/pendium"
}

Response: brand not found

{
  "error": "No brand found for the given name.",
  "code": "BRAND_NOT_FOUND"
}

Response: multiple matches

When searching by name and multiple brands match:

{
  "error": "Multiple brands match; use slug parameter.",
  "code": "MULTIPLE_MATCHES",
  "matches": [
    { "slug": "acme-corp", "name": "ACME Corp" },
    { "slug": "acme-labs", "name": "ACME Labs" }
  ]
}

Use the slug from the matches array to make a precise lookup.

Claim URLs

When looking up a brand with an API key, the response may include a claimUrl field. This is a one-time-use link that lets the brand owner claim and manage their Brand Index listing. Claim URLs are only included in authenticated responses.

On this page