add_topic | Pendium MCP Docs | Pendium.ai
Pendium MCP Docs

add_topic

Add a new visibility topic with optional queries.

Add a new visibility topic with optional queries. Topics group related search queries. Queries have a reach level that indicates how closely they relate to the brand.

Authentication: Required

Parameters

ParameterTypeRequiredDescription
syntheticIdintegerYesThe agent ID to add the topic to.
namestringYesTopic name, e.g., "AI Content Quality" or "Competitor Comparisons".
descriptionstringNoDescription of what this topic covers.
queriesarrayNoQueries to add to this topic.
queries[].querystringYes (within array)The search query text.
queries[].reachLevel"core" | "adjacent" | "aspirational" | "visionary"NoHow closely this query relates to the brand. Defaults to "core".

Example call

{
  "syntheticId": 1234,
  "name": "Competitor Comparisons",
  "description": "Queries comparing Example with competitors",
  "queries": [
    { "query": "Example vs CompetitorA", "reachLevel": "core" },
    { "query": "Best alternatives to CompetitorA", "reachLevel": "adjacent" },
    { "query": "AI visibility tool comparison 2026", "reachLevel": "adjacent" }
  ]
}

Response

{
  "success": true,
  "syntheticId": 1234,
  "topic": {
    "id": "topic-new",
    "name": "Competitor Comparisons",
    "description": "Queries comparing Example with competitors",
    "isActive": true,
    "queries": [
      { "id": "q-10", "query": "Example vs CompetitorA", "reachLevel": "core" },
      { "id": "q-11", "query": "Best alternatives to CompetitorA", "reachLevel": "adjacent" },
      { "id": "q-12", "query": "AI visibility tool comparison 2026", "reachLevel": "adjacent" }
    ]
  }
}

New topics and queries are automatically included in the next visibility scan.

On this page