Skip to main content
Glama

Observed AI citations & brand facts

ai_citations
Read-onlyIdempotent

This site's OWN first-party AI-citation data, the part no scan can see. observed_citations: citations recorded in REAL logged-in AI answers (ChatGPT, Perplexity, Gemini, Copilot, Claude, AI Overviews) by the user's browser extension, with per-engine counts and best rank - engines personalize and gate their APIs, so a server-side scan sees a de-personalized view while this sees what a real human was shown. brand_facts: the canonical business facts this site publishes for AI engines, plus internal-link health; use them to spot an AI answer contradicting the owner's own declaration. Counts only, never prompt or answer text. scan_results reads the latest server-side SCAN instead: per-engine brand visibility, the prompts where the brand was MISSED and who won them, competitors, and the sources engines cite. Observed vs scanned is the key distinction - observed is what a real logged-in human saw, scanned is a clean de-personalized baseline comparable over time. For AI traffic per page use traffic_analytics. Already scoped to the connected workspace and its site; no domain or site parameter is needed. Cost: FREE - reads your connected/stored data, no AI credits.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
daysNolook-back window in days (1-90, default 28).
actionYesWhich operation to run. observed_citations (real logged-in AI answers that cited this site); brand_facts (declared canonical facts + internal-link health); scan_results (latest scan: per-engine visibility, missed prompts, competitors, cited sources).
scanIdNoscan_results only: a specific scan id from recentScans. Omit for the latest completed scan.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • removedInput schema / properties / user_intent
      Removed value: -{
      -  "description": "Optional: one short sentence describing what the user is ultimately trying to achieve with this request. Used by SEOmatic to tailor answers and improve the product; never required.",
      -  "maxLength": 300,
      -  "type": "string"
      -}
  2. Changed3 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"Which operation to run. observed_citations (real logged-in AI answers that cited this site); brand_facts (declared canonical facts + internal-link health)."New value: +"Which operation to run. observed_citations (real logged-in AI answers that cited this site); brand_facts (declared canonical facts + internal-link health); scan_results (latest scan: per-engine visibility, missed prompts, competitors, cited sources)."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "observed_citations",
      -  "brand_facts"
      -]New value: +[
      +  "observed_citations",
      +  "brand_facts",
      +  "scan_results"
      +]
    • addedInput schema / properties / scanId
      Added value: +{
      +  "description": "scan_results only: a specific scan id from recentScans. Omit for the latest completed scan.",
      +  "type": "string"
      +}
  3. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.