---
name: pendium-mcp
description: Use when working with the Pendium MCP for AI visibility monitoring, content engineering, or brand analysis. Also use when the user mentions "visibility scan", "AI visibility", "brand score", "content strategy from Pendium data", or "Pendium MCP".
---

# Pendium MCP — Workflow Guide

Pendium monitors how ChatGPT, Claude, Gemini, and AI Overviews perceive and recommend brands. The MCP exposes 80+ tools across six areas — visibility monitoring, content strategy, content workflows (draft/schedule/publish blog posts), agent-site pages, knowledge queries, and configuration. Authentication is handled automatically via OAuth. See the full list at https://pendium.ai/docs/tools.

## Always Start Here

Call `get_account` first. It returns credit balance, plan tier, and all existing brand agents with their latest scores. This tells you whether you can scan, what agents already exist, and how many credits are left.

## Quick Brand Check (Free)

Use `lookup_brand_score` before paying for a full scan. It searches the public Brand Index by URL, name, or slug — no auth needed. If the brand has been scanned before, you get scores, competitors, and insights instantly.

Only trigger `scan_visibility` when the user needs a fresh, full scan with raw LLM responses.

## Visibility Scan Workflow

1. **Trigger:** `scan_visibility` with URL (new brand) or `syntheticId` (existing agent). Use `mode: "batch"` and `maxQueries: 30` as defaults — good balance of coverage and cost.
2. **Poll:** `get_scan_status` every 30–60 seconds. The `progress` object shows `completedQueries / totalQueries`. Do not call more frequently.
3. **Results:** When `scanAvailable: true`, call `get_report` for the full report with per-query analysis, platform scores, competitor data, and recommendations.
4. **History:** `get_scan_history` shows past scan scores and computed `scoreTrend` (improving/declining/stable).

## Content Engineering Workflow

Use these tools together to write data-grounded, on-brand content:

1. `get_goals` — strategic business goals that frame every piece of content.
2. `get_brand_voice` — tone traits, style guide, writing examples, company profile. Load this before writing anything.
3. `get_factsheet` — comprehensive brand overview and key facts for accuracy.
4. `query_knowledge` — semantic search over the brand's knowledge base (website content, uploaded docs) for specific claims and data points.
5. `list_analyzed_urls` — content plans in the pipeline.

## Action Queue Workflow

1. `get_recommendations` — prioritized action items from scan recommendations. Filter by `status` or `priority`.
2. Work through items — create content, do outreach, implement technical fixes.
3. `complete_action` — mark each action done to keep the queue accurate.

## Content Creation & Publishing Workflow

Pendium can create and publish content, not just advise on it. Ground every draft in the brand's own data (`get_brand_voice`, `get_factsheet`, `query_knowledge`) before generating.

1. `create_workflow` — start a content workflow from a seed (a goal, trend, list of URLs, or notes).
2. `generate_workflow_ideas` — have an LLM draft post ideas from the seed (or `add_workflow_ideas` to add specific ones with no LLM cost).
3. `run_workflow_pipeline` — generate the actual posts for every pending row.
4. `list_blog_posts` → `update_blog_post` (title/body/slug) / `regenerate_blog_post` / `generate_blog_post_image` — review and refine.
5. `publish_blog_post` or `schedule_blog_post` — publish to the agent site (and any connected CMS) now or later.

## Agent Site

Publish standalone pages to the brand's Pendium-hosted site (served at `/{username}/{slug}`).

- `list_site_pages` / `get_site_page` — see what's already there.
- `create_site_page` (from your content) or `generate_site_page` (LLM from a prompt); `generate_service_area_pages` for batch location pages.
- `publish_site_page` — take a page live; `set_site_public` must be on for the site to serve.

## Configuration

- `list_visibility_topics` / `add_visibility_topic` — view and add visibility topics with search queries (former names `list_topics`/`add_topic` still work as deprecated aliases).
- `list_visibility_personas` / `add_visibility_persona` — view and add buyer personas. Personas can be AI-generated from a prompt or defined manually (former names `list_personas`/`add_persona` still work as deprecated aliases).
- `list_knowledge_sources` — view ingested content sources (website pages, uploaded documents).

## Common Mistakes

| Mistake | Fix |
|---------|-----|
| Scanning without checking credits | Call `get_account` first |
| Using `scan_visibility` for a quick check | Use `lookup_brand_score` (free, instant) |
| Writing content without brand voice | Load `get_brand_voice` before writing |
| Polling too fast | 30–60s for scans |
| Assuming free users can scan via MCP | Free plan can only use `lookup_brand_score`; scans require Starter or Pro plan |