# cituna-mcp

Connects your agent to AI engine citations for your brand and joins the findings with Google Search Console data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: Cituna
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Cituna/cituna-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/cituna-mcp

## What it does

This server brings AI visibility metrics directly to your coding assistant. The platform queries 7 generative engines daily. It checks ChatGPT and Perplexity. Your agent sees exact citations and mentions alongside competing brands.

The integration provides 31 tools. That includes utilities for reading metrics and applying updates. It correlates AI answer receipts with Google Search Console traffic. Your agent can spot underperforming pages and schedule revisions.

The remote endpoint runs over Streamable HTTP at `https://mcp.cituna.com/mcp`. Running locally with `npx -y cituna-mcp` requires Node 20 or newer. MCP access is excluded from the free trial. You need a paid plan to use it.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.cituna.com/mcp`
- Environment variables: `CITUNA_API_KEY`, `CITUNA_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env CITUNA_API_KEY=<CITUNA_API_KEY> --env CITUNA_API_URL=<CITUNA_API_URL> --transport stdio cituna-mcp -- npx -y cituna-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http cituna-mcp https://mcp.cituna.com/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add cituna-mcp --url https://mcp.cituna.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add cituna-mcp --env CITUNA_API_KEY=<CITUNA_API_KEY> --env CITUNA_API_URL=<CITUNA_API_URL> -- npx -y cituna-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cituna-mcp": {
            "url": "https://mcp.cituna.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cituna-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cituna-mcp"
            ],
            "env": {
                "CITUNA_API_KEY": "<CITUNA_API_KEY>",
                "CITUNA_API_URL": "<CITUNA_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cituna-mcp": {
            "type": "http",
            "url": "https://mcp.cituna.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cituna-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "cituna-mcp"
            ],
            "env": {
                "CITUNA_API_KEY": "<CITUNA_API_KEY>",
                "CITUNA_API_URL": "<CITUNA_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http cituna-mcp https://mcp.cituna.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e CITUNA_API_KEY=<CITUNA_API_KEY> -e CITUNA_API_URL=<CITUNA_API_URL> cituna-mcp npx -y cituna-mcp
```
Replace <…> with your own values

## When to use it
- track brand citations across generative search engines
- identify competitors appearing in AI answers instead of your brand
- cross-reference AI search visibility with Google Search Console impressions
- queue content updates based on search gaps

## Example prompts
- Check how our website ranks across AI engines for our primary prompts
- Show what Perplexity answered for our target buyer query and what sites it cited
- Find queries with high Google Search Console impressions where AI engines never cite us

## Similar
- [google-search-console](https://affpapa.org/en/nevibecode/skills/google-search-console.md) — skill · 1900 installs
- [search-console-mcp](https://affpapa.org/en/nevibecode/plugins/search-console-mcp.md) — plugin · ★ 2043
- [Google Search Console](https://affpapa.org/en/nevibecode/mcp/google-search-console.md) — MCP server · ★ 9
- [Google Webtools MCP](https://affpapa.org/en/nevibecode/mcp/google-webtools-mcp.md) — MCP server · ★ 6
- [seo-geo](https://affpapa.org/en/nevibecode/skills/agricidaniel-seo-geo.md) — skill · 7300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md