@cite42/mcp 0.8.0 → 0.8.1

package/README.md

@@ -1,19 +1,42 @@
-# @cite42/mcp
+# Cite42: AI visibility and SEO data MCP server
 
-[![Cite42 MCP connector – tool definition quality and endpoint health on Glama](https://glama.ai/mcp/connectors/dev.cite42/mcp/badges/score.svg)](https://glama.ai/mcp/connectors/dev.cite42/mcp)
+[![npm](https://img.shields.io/npm/v/@cite42/mcp)](https://www.npmjs.com/package/@cite42/mcp)
+[![CI](https://github.com/Cite42/mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Cite42/mcp/actions/workflows/ci.yml)
+[![Cite42 MCP connector: tool definition quality and endpoint health on Glama](https://glama.ai/mcp/connectors/dev.cite42/mcp/badges/score.svg)](https://glama.ai/mcp/connectors/dev.cite42/mcp)
 
-MCP server for [Cite42, the AI search visibility, SEO keyword & trends API](https://www.cite42.dev): market research tools for your AI agent.
+Cite42 is an MCP server for AI visibility and SEO data. It works in Claude Code, Codex, Cursor, Claude Desktop and ChatGPT. Your agent can ask the AI models behind ChatGPT, Claude, Perplexity and Gemini, plus Google AI Overviews, a buyer question and see whether the answers mention your brand and which sources they cite. It can also pull keyword search volume, Google Trends, Reddit and YouTube data.
 
-Once connected, Claude Code, Claude Desktop, Codex CLI, Cursor, or ChatGPT can:
+You pay per call from a prepaid USD balance. There is no subscription, and new accounts get $1 of free credit. See [pricing](https://www.cite42.dev/pricing).
 
-- **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
-- **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
-- **Pull SEO data**: keyword search volume, CPC, competition, and Google Trends
-- **Research Reddit discussions and YouTube content** for audience questions, pain points, and content ideas
-- **Run full research workflows**: content gaps, topic demand, AI prompt maps, competitor analysis, and content briefs in a single call
+## What you can do with it
 
----
+### Check whether AI answers mention your brand
+
+Ask a buyer question such as "best invoicing software for freelancers" and see which brands each AI model names, in what order, and how often (`cite42_rankings`). Compare your brand with named competitors (`cite42_compare`), or see how the answers describe it (`cite42_sentiment`).
+
+### See which sources AI answers cite
+
+`cite42_citations` lists the URLs the AI models cited for a question and can check whether your page or domain is among them. For the full text, `cite42_search` returns each model's answer with its sources. `cite42_recommendations` then compares your page with up to two of the cited pages.
+
+### Keyword search volume, CPC and competition
+
+`cite42_keywords` returns monthly search volume, CPC and competition for a keyword, with optional related keyword ideas. `cite42_keywords_batch` checks up to 50 keywords in one call.
+
+### Google Trends
+
+`cite42_trends` returns Google Trends interest over time, related and rising queries, and a trend label.
+
+### Reddit and YouTube research
+
+`cite42_reddit_trends` finds relevant Reddit discussions with cited summaries. `cite42_youtube_trends` finds rising videos, creator angles and title patterns.
+
+### Track prompts weekly or monthly
+
+A tracker reruns up to 30 prompts every week or month and keeps the history, so you can see when AI answers start or stop naming your brand.
+
+### Run research workflows in one call
+
+Six workflows combine the tools above: content opportunities, topic demand, AI prompt maps, competitor content, AI citation gaps and content briefs.
 
 ## Requirements
 
@@ -108,6 +131,7 @@ After connecting or restarting, just ask in plain language. Your agent picks the
 - *"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'."*
+- *"Is interest in 'ai seo' rising on Google Trends? Show the related rising queries."*
 - *"What are people on Reddit complaining about regarding email marketing tools?"*
 - *"Run a content brief for the topic 'ai website builder'."*
 - *"Map the prompts worth tracking for our category, then create a weekly Cite42 rankings tracker for the best five. Show me the estimated cost in USD per run before activating it."*
@@ -131,6 +155,56 @@ After connecting or restarting, just ask in plain language. Your agent picks the
 
 That 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.
 
+## FAQ
+
+### Is there an MCP server for AI visibility?
+
+Yes. AI visibility is how often AI assistants name or cite your brand when people ask about your category, and Cite42 is an MCP server that measures it. Connect it to Claude Code, Codex, Cursor, Claude Desktop, Claude.ai or ChatGPT, and your agent can ask the AI models behind ChatGPT, Claude, Perplexity and Gemini, plus Google AI Overviews, the questions your buyers ask and see which brands and sources come back.
+
+### How can I track my brand's visibility in ChatGPT and other AI search engines?
+
+[Connect Cite42](#installation) and ask something like "Use Cite42 to check which brands AI models recommend for 'best CRM for startups'." Your agent calls `cite42_rankings`, which reports which brands each answer names, in what order and how often. It checks ChatGPT, Perplexity and Gemini by default; ask for a full sweep to add Claude and Google AI Overviews. To follow it over time, a [tracker](#trackers) reruns up to 30 prompts every week or month and keeps the history.
+
+### How can I see which websites ChatGPT, Claude and Perplexity cite?
+
+`cite42_citations` lists the URLs the AI answers cited for a question and checks whether your page or domain is among them. `cite42_find_ai_citation_gaps` finds the questions where AI answers cite your competitors but not you.
+
+### How do I get my brand mentioned by ChatGPT?
+
+Cite42 doesn't change what AI models say, but it shows you where to work. AI answers draw on the pages they cite, so start by finding those pages with `cite42_citations`. `cite42_recommendations` then compares your page with up to two of the cited pages and suggests changes, and a tracker shows whether your brand starts to appear.
+
+### Is there an MCP server for keyword research with real search volume?
+
+Yes. Ask your agent for a keyword's search volume and it calls `cite42_keywords`, which returns monthly search volume, CPC and competition, with optional related keyword ideas. `cite42_keywords_batch` checks up to 50 keywords in one call.
+
+### Is there a Google Trends MCP server?
+
+Yes. `cite42_trends` returns Google Trends interest over time, related and rising queries, and a trend label, so you can ask "Is interest in 'ai seo' rising?" and get an answer from the data. `cite42_reddit_trends` and `cite42_youtube_trends` cover Reddit discussions and rising YouTube videos.
+
+### How do I find content gaps between AI answers and keyword demand?
+
+`cite42_find_content_opportunities` combines AI answers, keyword demand, Google Trends, Reddit, YouTube and citations in one call to find topics you haven't covered.
+
+### Can I check AI visibility without a monthly subscription?
+
+Yes. Cite42 charges per call from a prepaid USD balance, and there is no subscription. A rankings or citations check costs $0.13 on the three default surfaces (ChatGPT $0.05, Gemini $0.05, Perplexity $0.03) and $0.20 with all five. Failed calls are not charged, and new accounts get $1 of free credit. See [cite42.dev/pricing](https://www.cite42.dev/pricing), or ask your agent to run `cite42_pricing`.
+
+### Is there an AI visibility API for developers?
+
+Yes. The same tools are available as a REST API at the same per-call prices, so you can build AI visibility checks into your own app. See the [REST API docs](https://www.cite42.dev/docs/api).
+
+### Are the answers live?
+
+Each answer comes from a real call to that AI model. Cite42 caches answers for 24 hours, shared across customers, so an identical prompt on the same surface can return an answer from up to a day earlier. Scheduled tracker runs are a week or a month apart, so they always fall outside that window.
+
+### Do I need an API key?
+
+Not for the hosted server at `https://mcp.cite42.dev`, where you sign in with your Cite42 account in the browser. You only need a key to run this npm package, for example in CI or on a server without a browser.
+
+### Is it open source?
+
+This MCP client is MIT licensed. The data comes from the hosted Cite42 API, which is not open source.
+
 ## Tools
 
 Cite42 exposes 29 MCP tools: 4 free account tools (including the compatibility alias), 11 data/report tools, 6 research workflows, and 8 tracker tools.
@@ -196,24 +270,34 @@ Tool and workflow calls charge your Cite42 balance in USD. Tracker management an
 
 ## Troubleshooting
 
-For contributor testing, run `npm run inspect` to open the official MCP Inspector with local
-stdio, published npm, and local OAuth targets. Run `npm run test:stdio` for a free built-executable
-smoke test against a loopback fake API. See [local MCP testing](../../docs/mcp-testing.md) in the repository.
-
 - **Server not listed after setup**: make sure you fully restarted the client (new terminal for CLI clients, full quit for desktop apps).
 - **"No Cite42 account is linked to this sign-in"**: you signed in with a different account than the one you use at cite42.dev. In Claude Code run `claude mcp logout cite42`, then `claude mcp login cite42` and pick the same sign-in method as on the dashboard.
 - **`command not found: npx`**: install Node.js 22.13+ from [nodejs.org](https://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](https://www.cite42.dev/app/keys).
 - **Tool calls fail with an insufficient-balance error**: add funds at [www.cite42.dev/app](https://www.cite42.dev/app).
 
+## Development
+
+This repository is the source of the [`@cite42/mcp`](https://www.npmjs.com/package/@cite42/mcp) package on npm. It is a thin client: each tool calls the hosted Cite42 API, which runs the AI and data queries.
+
+```bash
+npm ci
+npm run build
+npm test            # unit tests
+npm run test:stdio  # runs the built executable against a local fake API; no key, no paid calls
+```
+
+Report bugs in [GitHub issues](https://github.com/Cite42/mcp/issues) or email support@cite42.dev.
+
 ## Links
 
 - Website: [Cite42: AI visibility and SEO data for AI agents](https://www.cite42.dev)
 - API keys: [Create a Cite42 API key](https://www.cite42.dev/app/keys)
 - Docs: [Cite42 API & MCP documentation](https://www.cite42.dev/docs)
 - Pricing: [Cite42 pay-per-call pricing](https://www.cite42.dev/pricing)
+- npm: [@cite42/mcp](https://www.npmjs.com/package/@cite42/mcp)
 
-### USD billing
+## USD billing
 
 Every paid result carries a `cite42Billing` block with the amount charged and the remaining
 Cite42 balance. Its `chargedUsd` and `remainingUsd` values are decimal strings in USD.

package/dist/stdio.cjs

@@ -674,7 +674,7 @@ if (!resolveApiKey()) {
   );
   process.exit(1);
 }
-buildCite42Server("0.8.0").startStdio().catch((error) => {
+buildCite42Server("0.8.1").startStdio().catch((error) => {
   console.error("[@cite42/mcp] Fatal error:", error);
   process.exit(1);
 });

package/dist/stdio.mjs

@@ -673,7 +673,7 @@ if (!resolveApiKey()) {
   );
   process.exit(1);
 }
-buildCite42Server("0.8.0").startStdio().catch((error) => {
+buildCite42Server("0.8.1").startStdio().catch((error) => {
   console.error("[@cite42/mcp] Fatal error:", error);
   process.exit(1);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cite42/mcp",
   "mcpName": "dev.cite42/mcp",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Cite42 MCP server: AI visibility and SEO data for AI agents. See how the AI models behind ChatGPT, Claude, Perplexity and Gemini, plus Google AI Overviews, mention your brand and which sources they cite, with SEO keyword data, Google, Reddit and YouTube trends, and weekly or monthly trackers that watch a list of prompts over time. Works with Claude Code, Claude Desktop, Codex CLI, Cursor, and any MCP client.",
   "license": "MIT",
   "type": "module",
@@ -73,11 +73,16 @@
   },
   "author": "Cite42 <support@cite42.dev> (https://www.cite42.dev)",
   "homepage": "https://www.cite42.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cite42/mcp.git"
+  },
   "bugs": {
     "email": "support@cite42.dev",
     "url": "https://www.cite42.dev/app/support"
   },
   "overrides": {
-    "esbuild": "^0.28.2"
+    "esbuild": "^0.28.2",
+    "@modelcontextprotocol/client": "2.3.1"
   }
 }