{
  "markdown": "# @cite42/mcp\n\nMCP server for [Cite42, the AI search visibility, SEO keyword & trends API](https://www.cite42.dev): market research tools for your AI agent.\n\nOnce connected, Claude Code, Claude Desktop, Codex CLI, or Cursor can:\n\n- **Query AI models** (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) and see each model's answer and the sources it cites\n- **Track brand visibility** in AI answers: rankings, head-to-head comparisons, and sentiment\n- **Schedule weekly or monthly trackers**: one measurement — rankings, comparisons, citations, or sentiment — over a list of prompts, with setup confirmation and a useful email after every run, then ask your agent for stored history\n- **Pull SEO data**: keyword search volume, CPC, competition, and Google Trends\n- **Mine Reddit and YouTube** for audience questions, pain points, and rising content\n- **Run full research workflows**: content gaps, topic demand, AI prompt maps, competitor analysis, and content briefs in a single call\n\n---\n\n## Requirements\n\n- **A Cite42 account**, free to create at [cite42.dev](https://www.cite42.dev)\n- **Node.js 18 or newer and a Cite42 API key** for Claude Code, Codex CLI, and Cursor\n\n## Installation\n\nClaude Desktop connects to Cite42 through the hosted remote MCP URL and OAuth. Claude Code, Codex CLI, and Cursor run this package on demand with `npx -y @cite42/mcp`.\n\n### Step 1: Get your API key for local clients\n\nSkip this step for Claude Desktop; its hosted connector authorizes through sign-in.\n\n1. Sign in at [cite42.dev](https://www.cite42.dev)\n2. Open **Dashboard → API Keys**: [www.cite42.dev/app/keys](https://www.cite42.dev/app/keys)\n3. Create a key and copy it (it looks like `cite42_live_...`)\n\n### Step 2: Add the server to your client\n\nPick **one** of the clients below. For Claude Code, Codex CLI, and Cursor, replace `cite42_live_your_key_here` with your real key.\n\n#### Claude Code\n\n```bash\nclaude mcp add cite42 -e CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp\n```\n\n#### Claude Desktop\n\n1. Open **Settings → Connectors** and click **Add**.\n2. Select **Add custom connector**.\n3. Enter **Cite42** for the name and paste this remote MCP URL:\n\n```text\nhttps://mcp.cite42.dev\n```\n\n4. Click **Connect** and complete the Cite42 sign-in. No API key is required.\n\nThe same hosted-connector steps apply in Claude.ai.\n\n#### Codex CLI\n\n```bash\ncodex mcp add cite42 --env CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp\n```\n\n#### Cursor\n\nAdd this under **Settings → MCP**, or save it to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cite42\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cite42/mcp\"],\n      \"env\": {\n        \"CITE42_API_KEY\": \"cite42_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Step 3: Restart so the server loads\n\nLocal MCP servers are started by the client, so their config is only picked up on a fresh start. The Claude Desktop connector is ready after sign-in.\n\n- **Claude Code / Codex CLI**: exit the current session and open a **new terminal** (or start a new `claude` / `codex` session)\n- **Cursor**: fully quit and reopen the app\n\nYou do not need to keep `npx -y @cite42/mcp` running in a separate terminal. Local MCP clients start it automatically when the session needs tools.\n\n### Step 4: Verify it's running\n\n- **Claude Code:** run `claude mcp list` and check that `cite42` shows as ✔ connected. Or type `/mcp` inside a session.\n- **Claude Desktop:** open **Settings → Connectors** and confirm Cite42 is connected.\n- **Codex CLI:** run `codex mcp list`.\n- **Cursor:** look for `cite42` in the MCP/tools indicator. 26 tools should be listed.\n\nIf it doesn't appear, see [Troubleshooting](#troubleshooting).\n\n## Try it: example prompts\n\nAfter connecting or restarting, just ask in plain language. Your agent picks the right Cite42 tool automatically.\n\n- *\"Use Cite42 to check which brands AI models recommend for 'best project management software'.\"*\n- *\"Which sources do AI models cite when asked about CRM tools for startups? Is mycompany.com among them?\"*\n- *\"Get search volume, CPC, and related keywords for 'ai seo tools'.\"*\n- *\"What are people on Reddit complaining about regarding email marketing tools?\"*\n- *\"Run a content brief for the topic 'ai website builder'.\"*\n- *\"Map the prompts worth tracking for our category, then create a weekly Cite42 rankings tracker for the best five. Show me the estimated credits per run before activating it.\"*\n\n### Example: what a session looks like\n\n**You ask:**\n\n> Use Cite42 to find AI-cited competitors for \"best invoicing software for freelancers\".\n\n**Your agent calls** `cite42_citations` **and answers something like:**\n\n> Across ChatGPT, Perplexity, and Gemini, the most-cited sources are:\n>\n> 1. **freshbooks.com** (cited by 3/3 models)\n> 2. **wave.com** (cited by 2/3 models)\n> 3. **zoho.com/invoice** (cited by 2/3 models)\n> 4. **bonsai.com** (cited by 1/3 models)\n>\n> Your domain wasn't cited by any model. FreshBooks is cited mainly via comparison/\"best of\" listicles. A citation-gap analysis (`cite42_find_ai_citation_gaps`) can show which queries you're missing from.\n\nThat is the three default surfaces; ask for `fullSweep` to add Claude and Google AI Overviews. The exact brands and sources change by query and model. A good result should show the tool used, model/source evidence, and a short summary you can act on.\n\n## Tools\n\nCite42 exposes 26 MCP tools: 3 free account tools, 9 data tools, 6 research workflows, and 8 tracker tools.\n\n### Account & pricing (free)\n\n- `cite42_credits`: check the connected account's remaining Cite42 credit balance.\n- `cite42_pricing`: get current per-tool prices and estimate a planned set of calls.\n- `cite42_usage`: read recent call status and cost together with the remaining balance.\n\n### AI search visibility\n\n- `cite42_search`: run a query against ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews. Returns each model's answer plus cited sources.\n- `cite42_citations`: aggregate which URLs the AI models cite for a query. Can also check whether a specific URL is cited.\n- `cite42_rankings`: measure how brands rank in AI answers, including mention rate, average position, and per-model breakdown.\n- `cite42_compare`: compare one brand against competitors in AI answers.\n- `cite42_sentiment`: score positive, neutral, and negative sentiment for a brand, with supporting phrases.\n\n### SEO & trend data\n\n- `cite42_keywords`: get seed search volume, CPC, and competition, with optional related keyword ideas.\n- `cite42_trends`: get Google Trends interest over time, related and rising queries, and a trend label.\n- `cite42_reddit_trends`: find Reddit audience questions, pain points, rising threads, and product mentions.\n- `cite42_youtube_trends`: find YouTube rising videos, creator angles, title patterns, and opportunities.\n\n### Research workflows (multi-source, one call)\n\n- `cite42_find_content_opportunities`: find content gaps across AI search, keywords, trends, Reddit, YouTube, and citations.\n- `cite42_analyze_topic_demand`: combine keyword data, trends, AI answers, and audience conversations for a topic.\n- `cite42_map_ai_prompts`: discover and cluster buyer prompts worth tracking in AI search. Its prompts are what `cite42_tracker_create` takes, so the two chain naturally.\n- `cite42_analyze_competitor_content`: analyze AI rankings, comparisons, citations, and topic coverage for competitors.\n- `cite42_find_ai_citation_gaps`: find queries where AI answers cite competitors but not your brand, domain, or URL.\n- `cite42_generate_content_brief`: collect AI answers, citations, keyword demand, and social signals into brief-ready data.\n\n### Trackers\n\n- `cite42_tracker_create`: create a draft weekly or monthly tracker — one measurement applied to a list of prompts. No prompt list yet? Run `cite42_map_ai_prompts` first. Creating a draft is free and does not schedule calls.\n- `cite42_tracker_update`: replace the whole tracker definition — name, cadence, measurement, prompts and configuration. A tracker read returns the same shape, so read it, change what you need, and send it back. Updating is free.\n- `cite42_tracker_activate`: activate or resume recurring runs. You must pass the exact `estimatedCostMicroPerRun` from the latest tracker record as `maxCostMicroPerRun`; activation authorizes billed scheduled runs until the tracker is paused. The response carries the balance, the cost per run and `runsDryAt` — the date the balance stops covering your active trackers — and activation is refused when the balance cannot cover even the next run. When tracker emails are on, activation also sends a setup summary.\n- `cite42_tracker_pause`: stop future scheduled runs while preserving configuration and history. Pausing is free.\n- `cite42_tracker_delete`: permanently delete a draft or paused tracker and its run history. Active trackers must be paused first, and deletion is rejected while a run is queued or running. Financial usage records remain available.\n- `cite42_tracker_run`: queue one manual run of every saved prompt. Each prompt is billed as its own tool call at the normal rate, and completion sends the same current-results email as a scheduled run—even for a baseline or an unchanged result.\n- `cite42_trackers`: list trackers, schedules, statuses, cost estimates, and last/next run times. Reading the list is free.\n- `cite42_tracker_report`: read bounded stored run history with results, changes, status, sampled time, and costs (latest 8 by default, up to 20). Reading stored reports is free.\n\n## Configuration\n\n- `CITE42_API_KEY`: required. Your API key from [www.cite42.dev/app/keys](https://www.cite42.dev/app/keys).\n- `CITE42_API_BASE`: optional. Defaults to `https://www.cite42.dev/api/v1`.\n\nYou can also pass these as CLI flags instead of environment variables:\n\n```bash\nnpx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://www.cite42.dev/api/v1\n```\n\n## Billing\n\nTool and workflow calls consume Cite42 credits from your account. Tracker management and stored-history reads are free; every scheduled or manual tracker run bills one call per saved prompt at the normal rate. Activating or resuming a tracker requires explicit confirmation of the current maximum credits per run and authorizes recurring billed calls until you pause it. Calls fail with a clear error if the API key is missing or credits run out. See [www.cite42.dev/pricing](https://www.cite42.dev/pricing).\n\n## Troubleshooting\n\n- **Server not listed after setup**: make sure you fully restarted the client (new terminal for CLI clients, full quit for desktop apps).\n- **`command not found: npx`**: install Node.js 18+ from [nodejs.org](https://nodejs.org), then restart your terminal.\n- **Tool calls fail with an auth error**: check the key was passed correctly (`CITE42_API_KEY`, no quotes or trailing spaces) and is active at [www.cite42.dev/app/keys](https://www.cite42.dev/app/keys).\n- **Tool calls fail with a credits error**: top up credits at [www.cite42.dev/app](https://www.cite42.dev/app).\n\n## Links\n\n- Website: [Cite42 MCP: AI search visibility, brand rankings, SEO keywords & trends](https://www.cite42.dev)\n- API keys: [Create a Cite42 API key](https://www.cite42.dev/app/keys)\n- Docs: [Cite42 API & MCP documentation](https://www.cite42.dev/docs)\n- Pricing: [Cite42 pay-per-call pricing](https://www.cite42.dev/pricing)",
  "bytes": 11354,
  "sha": "1d758567debe298aa41eb48f95e1946356f2c087db7897602b8fa49ae080a60a",
  "repo_slug": "",
  "fonte": "npm",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_cite42_mcp_866afba6/readme"
}