@cite42/mcp
MCP server for Cite42, the AI search visibility, SEO keyword & trends API: market research tools for your AI agent.
Once connected, Claude Code, Claude Desktop, Codex CLI, or Cursor can:
- Query AI models (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) and see each model's answer and the sources it cites
- Track brand visibility in AI answers: rankings, head-to-head comparisons, and sentiment
- Pull SEO data: keyword search volume, CPC, competition, and Google Trends
- Mine Reddit and YouTube for audience questions, pain points, and rising content
- Run full research workflows: content gaps, topic demand, AI prompt maps, competitor analysis, and content briefs in a single call
Requirements
- A Cite42 account, free to create at cite42.dev
- Node.js 18 or newer and a Cite42 API key for Claude Code, Codex CLI, and Cursor
Installation
Claude 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.
Step 1: Get your API key for local clients
Skip this step for Claude Desktop; its hosted connector authorizes through sign-in.
Step 2: Add the server to your client
Pick one of the clients below. For Claude Code, Codex CLI, and Cursor, replace cite42_live_your_key_here with your real key.
Claude Code
claude mcp add cite42 -e CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
Claude Desktop
- Open Settings → Connectors and click Add.
- Select Add custom connector.
- Enter Cite42 for the name and paste this remote MCP URL:
https://mcp.cite42.dev
- Click Connect and complete the Cite42 sign-in. No API key is required.
The same hosted-connector steps apply in Claude.ai.
Codex CLI
codex mcp add cite42 --env CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
Cursor
Add this under Settings → MCP, or save it to ~/.cursor/mcp.json:
{
"mcpServers": {
"cite42": {
"command": "npx",
"args": ["-y", "@cite42/mcp"],
"env": {
"CITE42_API_KEY": "cite42_live_your_key_here"
}
}
}
}
Step 3: Restart so the server loads
Local 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.
- Claude Code / Codex CLI: exit the current session and open a new terminal (or start a new
claude / codex session)
- Cursor: fully quit and reopen the app
You 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.
Step 4: Verify it's running
- Claude Code: run
claude mcp list and check that cite42 shows as ✔ connected. Or type /mcp inside a session.
- Claude Desktop: open Settings → Connectors and confirm Cite42 is connected.
- Codex CLI: run
codex mcp list.
- Cursor: look for
cite42 in the MCP/tools indicator. 15 tools should be listed.
If it doesn't appear, see Troubleshooting.
Try it: example prompts
After connecting or restarting, just ask in plain language. Your agent picks the right Cite42 tool automatically.
- "Use Cite42 to check which brands AI models recommend for 'best project management software'."
- "Which sources do AI models cite when asked about CRM tools for startups? Is mycompany.com among them?"
- "Get search volume, CPC, and related keywords for 'ai seo tools'."
- "What are people on Reddit complaining about regarding email marketing tools?"
- "Run a content brief for the topic 'ai website builder'."
Example: what a session looks like
You ask:
Use Cite42 to find AI-cited competitors for "best invoicing software for freelancers".
Your agent calls cite42_citations and answers something like:
Across ChatGPT, Claude, Perplexity, and Gemini, the most-cited sources are:
- freshbooks.com (cited by 4/5 models)
- wave.com (cited by 3/5 models)
- zoho.com/invoice (cited by 3/5 models)
- bonsai.com (cited by 2/5 models)
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.
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.
Endpoint tools
AI search visibility
cite42_search: run a query against ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews. Returns each model's answer plus cited sources.
cite42_citations: aggregate which URLs the AI models cite for a query. Can also check whether a specific URL is cited.
cite42_rankings: measure how brands rank in AI answers, including mention rate, average position, and per-model breakdown.
cite42_compare: compare one brand against competitors in AI answers.
cite42_sentiment: score positive, neutral, and negative sentiment for a brand, with supporting phrases.
SEO & trend data
cite42_keywords: get seed search volume, CPC, and competition, with optional related keyword ideas.
cite42_trends: get Google Trends interest over time, related and rising queries, and a trend label.
cite42_reddit_trends: find Reddit audience questions, pain points, rising threads, and product mentions.
cite42_youtube_trends: find YouTube rising videos, creator angles, title patterns, and opportunities.
Research workflows (multi-source, one call)
cite42_find_content_opportunities: find content gaps across AI search, keywords, trends, Reddit, YouTube, and citations.
cite42_analyze_topic_demand: combine keyword data, trends, AI answers, and audience conversations for a topic.
cite42_map_ai_prompts: discover and cluster buyer prompts worth tracking in AI search.
cite42_analyze_competitor_content: analyze AI rankings, comparisons, citations, and topic coverage for competitors.
cite42_find_ai_citation_gaps: find queries where AI answers cite competitors but not your brand, domain, or URL.
cite42_generate_content_brief: collect AI answers, citations, keyword demand, and social signals into brief-ready data.
Configuration
CITE42_API_KEY: required. Your API key from www.cite42.dev/app/keys.
CITE42_API_BASE: optional. Defaults to https://www.cite42.dev/api/v1.
You can also pass these as CLI flags instead of environment variables:
npx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://www.cite42.dev/api/v1
Billing
Tool calls consume Cite42 credits from your account. Calls fail with a clear error if the API key is missing or credits run out. See www.cite42.dev/pricing.
Troubleshooting
- Server not listed after setup: make sure you fully restarted the client (new terminal for CLI clients, full quit for desktop apps).
command not found: npx: install Node.js 18+ from nodejs.org, then restart your terminal.
- 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.
- Tool calls fail with a credits error: top up credits at www.cite42.dev/app.
Links