Cituna MCP Server

Cituna — MCP server & Looker Studio connector

The AI visibility tool you use from inside the AI. Every other tool in this category hands you a dashboard and leaves the thinking to you. Cituna puts the measurements where you already do the reasoning: ask Claude why ChatGPT never mentions you, and it can pull the answer receipts, cross-check them against what Google already sends you, and queue the page that fixes it, without you opening a tab.

Links: npm package · MCP registry listing (com.cituna/cituna-mcp) · docs and pricing

Two client integrations for Cituna, which tracks how AI answer engines — ChatGPT, Perplexity, Gemini, Claude, Grok and Google AI Overviews — mention and cite your brand.

Both are thin clients over the Cituna REST API. They hold no secrets: you paste a personal API key, and everything else (Google OAuth refresh tokens, the database, the scan pipeline) stays server-side.

---

MCP server

Install

npx cituna-mcp

Or wire it into Claude Desktop / Claude Code:

{
  "mcpServers": {
    "cituna": {
      "command": "npx",
      "args": ["-y", "cituna-mcp"],
      "env": { "CITUNA_API_KEY": "cituna_sk_..." }
    }
  }
}

Generate a key in the app under Integrations → Claude / MCP access. It is shown once. The same key works for the Looker connector.

Configuration

Tools

Twelve read tools work on Starter and above. The four write tools — run_scan, set_gap_status, queue_article and mark_article_published — require Pro. The 3-day trial is app-only and has no MCP access.

Connecting Google Search Console

The gsc_* tools need a one-time connect in the Cituna app (Integrations → Connect Google Search Console, paid plans). Google asks for read-only Search Console access; pick the Google account where your domain is a verified property, or every query will come back empty. Verify with gsc_status, which lists the connected account and its queryable properties. Disconnecting in the app revokes this server's access instantly. There is no Google OAuth in this server itself: consent happens in the app and the refresh token stays server-side.

What it looks like

A real first conversation, once the key is set:

You: We sell scheduling software. Why does ChatGPT never mention us?

Claude: (whoami → Pro, 4 of 25 scans used · list_brands → acme.com · gsc_status → connected) Running the not-cited diagnosis on acme.com.

(get_visibility) You are cited in 3 of 18 prompt×engine cells. ChatGPT answers all six of your category prompts and cites you in none of them.

(get_engine_answers on the 3 biggest) For "best scheduling software for clinics" ChatGPT cites Calendly, Acuity and a Capterra roundup. Every citation is a third-party list. Not one is a vendor's own site, including your rivals'.

(gsc_query) Google already sends you 1,240 impressions for that intent at average position 8.4. So this is not an indexation problem.

The finding: you are Google-visible and AI-invisible. ChatGPT builds that answer out of roundups you are absent from, so no amount of on-site work moves it. The lever is getting into those lists.

(list_keywords stage:"none") "scheduling software for clinics" has demand and no page behind it. Want me to queue it? (queue_article)

Nothing above spends a scan: it is all reads over data Cituna already collected.

Built-in prompts

Five reusable analysis workflows, surfaced in Claude's prompt picker via the MCP prompts API. You do not have to pick one from the picker: the server tells Claude which workflow matches which kind of question, so plain English routes itself. Each encodes a join between Search Console data and the engines' actual answer text:

• why-am-i-not-cited — classifies every uncited prompt: invisible everywhere, Google-visible but AI-invisible, or partially cited, with evidence
• gsc-to-ai-gap — queries with real Google impressions where AI never cites you
• competitor-teardown — who the engines actually cite, diffed against your configured competitor list
• weekly-review — wins, regressions, and the week's 3 actions; reads only
• prioritize-fixes — re-ranks the fix queue by the impressions each gap touches

None of them triggers a paid scan on its own.

Troubleshooting

"API key invalid, revoked, or the account no longer has access" — regenerate under Integrations → Claude / MCP access (keys never expire on their own; this means the key was revoked or mistyped, or the account lost access). If the key is definitely current, check CITUNA_API_URL has no trailing path and is not an origin that redirects: a cross-origin redirect strips the Authorization header, which surfaces as this exact message.

Requires Node 18.17+.

---

Looker Studio connector

See looker-connector/README.md for the full setup. Summary: deploy Code.gs as a Google Apps Script community connector, paste your cituna_sk_… key on the KEY auth screen, and build dashboards on your visibility data.

---

About this repository

This is a published mirror, not the working tree. Both integrations are developed in Cituna's private monorepo and released here automatically on tag, so the connector's engine list stays pinned to what the API actually serves.

Pull requests against this repo can't be merged directly — but issues are read and acted on, so please do open them.

MIT licensed. Bugs and requests: https://github.com/cituna/cituna-mcp/issues