@cite42/mcp 0.8.2 → 0.9.0

package/README.md

@@ -55,6 +55,14 @@ claude mcp add --transport http --scope user cite42 https://mcp.cite42.dev && cl
 
 Your browser opens to sign in. Then start Claude Code, or restart it if it was already open, and check with `/mcp`.
 
+Or install Cite42 as a plugin from inside Claude Code:
+
+```
+/plugin install cite42 --marketplace Cite42/mcp
+```
+
+Claude Code versions before 2.1.275 need two steps: `/plugin marketplace add Cite42/mcp`, then `/plugin install cite42@cite42`. Then open `/mcp`, pick the Cite42 server and sign in.
+
 ### Codex CLI
 
 ```bash

package/dist/stdio.cjs

@@ -217,6 +217,15 @@ function optionalShortText(description) {
 }
 var modelsInput = import_zod.z.array(modelEnum).nonempty().optional().describe(MODEL_SELECTION_DESCRIPTION);
 var fullSweepInput = import_zod.z.boolean().optional().describe(FULL_SWEEP_DESCRIPTION);
+var AI_MARKETS_ENABLED = true;
+var aiMarketInput = AI_MARKETS_ENABLED ? {
+  country: import_zod.z.string().trim().max(8).optional().describe(
+    `Optional ISO-2 country to measure from, e.g. "gb". Omit for each surface's default. Gemini has no country setting and ignores it.`
+  ),
+  language: import_zod.z.string().trim().max(8).optional().describe(
+    "Optional ISO-2 language for google_ai_overview and chatgpt_app, which read in it. Needs country; defaults to the country's main language."
+  )
+} : {};
 var competitorList = import_zod.z.array(shortText("Competitor brand/domain name.")).nonempty().max(20);
 async function fetchBalance() {
   const usage = await aivGet("/usage");
@@ -277,7 +286,8 @@ var aivSearch = (0, import_tools.createTool)({
   inputSchema: import_zod.z.object({
     query: queryText("The concise AI-search/market-research query to run against the selected models."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/search", input)
 });
@@ -289,7 +299,8 @@ var aivCitations = (0, import_tools.createTool)({
     query: queryText("The concise query to look up cited sources for."),
     url: import_zod.z.string().trim().max(500).optional().describe("Optional URL to check whether it was cited."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/citations", input)
 });
@@ -301,7 +312,8 @@ var aivRankings = (0, import_tools.createTool)({
     query: queryText("The concise query to measure brand/competitor visibility on."),
     competitors: competitorList.describe("Brand or domain names to track within the AI-generated answers."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/rankings", input)
 });
@@ -314,7 +326,8 @@ var aivCompare = (0, import_tools.createTool)({
     brand: shortText("Your brand, ranked alongside the competitors."),
     competitors: import_zod.z.array(shortText("Competitor brand/domain name.")).nonempty().max(10).describe("Competitor brand/domain names (up to 10) to rank against your brand."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/compare", input)
 });
@@ -326,7 +339,8 @@ var aivSentiment = (0, import_tools.createTool)({
     query: queryText("The concise query whose answers are scored for brand sentiment."),
     brand: shortText("The brand to score sentiment for in each model answer."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/sentiment", input)
 });
@@ -363,6 +377,24 @@ var aivKeywordsBatch = (0, import_tools.createTool)({
   }),
   execute: async (input) => aivPost("/keywords/batch", input)
 });
+var aivKeywordRankings = (0, import_tools.createTool)({
+  id: "cite42_keyword_rankings",
+  mcp: readOnly("Get Google keyword rankings"),
+  description: `Where a site ranks in Google organic results (top 100) for one to five keywords in one country, desktop or mobile: position, ranking URL, competitor positions, the top 10 and whether the AI Overview cites the site. Billed per keyword checked; a keyword that fails is free. Each check is one live sample. ${PAID_TOOL_BILLING}`,
+  inputSchema: import_zod.z.object({
+    keywords: import_zod.z.array(import_zod.z.string().trim().min(1).max(200)).min(1).max(5).refine(
+      (keywords) => new Set(keywords.map((keyword) => keyword.toLowerCase().replace(/\s+/g, " "))).size === keywords.length,
+      "Keywords must be distinct."
+    ).describe("One to five distinct search terms, as people type them into Google. Each is billed separately."),
+    domain: import_zod.z.string().trim().max(253).optional().describe("Your site, e.g. example.com. Covers www and subdomains. Omit to get only the top results."),
+    url: import_zod.z.string().trim().max(500).optional().describe("Optional page that should rank, as a full URL or a path such as /pricing."),
+    competitors: import_zod.z.array(import_zod.z.string().trim().min(1).max(253)).max(5).optional().describe("Up to 5 competitor domains to report positions for."),
+    country: import_zod.z.string().trim().max(8).optional().describe('ISO-2 country code of the Google market to check. Defaults to "us".'),
+    language: import_zod.z.string().trim().max(8).optional().describe("Optional ISO-2 language code. Defaults to the country's main language."),
+    device: import_zod.z.enum(["desktop", "mobile"]).optional().describe("Desktop or mobile results. Defaults to desktop.")
+  }),
+  execute: async (input) => aivPost("/keywords/rankings", input)
+});
 var aivTrends = (0, import_tools.createTool)({
   id: "cite42_trends",
   mcp: readOnly("Get Google Trends data"),
@@ -639,6 +671,7 @@ var CITE42_TOOLS = {
   cite42_recommendations: aivRecommendations,
   cite42_keywords: aivKeywords,
   cite42_keywords_batch: aivKeywordsBatch,
+  cite42_keyword_rankings: aivKeywordRankings,
   cite42_trends: aivTrends,
   cite42_reddit_trends: aivRedditTrends,
   cite42_youtube_trends: aivYoutubeTrends,
@@ -674,7 +707,7 @@ if (!resolveApiKey()) {
   );
   process.exit(1);
 }
-buildCite42Server("0.8.2").startStdio().catch((error) => {
+buildCite42Server("0.9.0").startStdio().catch((error) => {
   console.error("[@cite42/mcp] Fatal error:", error);
   process.exit(1);
 });

package/dist/stdio.mjs

@@ -216,6 +216,15 @@ function optionalShortText(description) {
 }
 var modelsInput = z.array(modelEnum).nonempty().optional().describe(MODEL_SELECTION_DESCRIPTION);
 var fullSweepInput = z.boolean().optional().describe(FULL_SWEEP_DESCRIPTION);
+var AI_MARKETS_ENABLED = true;
+var aiMarketInput = AI_MARKETS_ENABLED ? {
+  country: z.string().trim().max(8).optional().describe(
+    `Optional ISO-2 country to measure from, e.g. "gb". Omit for each surface's default. Gemini has no country setting and ignores it.`
+  ),
+  language: z.string().trim().max(8).optional().describe(
+    "Optional ISO-2 language for google_ai_overview and chatgpt_app, which read in it. Needs country; defaults to the country's main language."
+  )
+} : {};
 var competitorList = z.array(shortText("Competitor brand/domain name.")).nonempty().max(20);
 async function fetchBalance() {
   const usage = await aivGet("/usage");
@@ -276,7 +285,8 @@ var aivSearch = createTool({
   inputSchema: z.object({
     query: queryText("The concise AI-search/market-research query to run against the selected models."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/search", input)
 });
@@ -288,7 +298,8 @@ var aivCitations = createTool({
     query: queryText("The concise query to look up cited sources for."),
     url: z.string().trim().max(500).optional().describe("Optional URL to check whether it was cited."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/citations", input)
 });
@@ -300,7 +311,8 @@ var aivRankings = createTool({
     query: queryText("The concise query to measure brand/competitor visibility on."),
     competitors: competitorList.describe("Brand or domain names to track within the AI-generated answers."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/rankings", input)
 });
@@ -313,7 +325,8 @@ var aivCompare = createTool({
     brand: shortText("Your brand, ranked alongside the competitors."),
     competitors: z.array(shortText("Competitor brand/domain name.")).nonempty().max(10).describe("Competitor brand/domain names (up to 10) to rank against your brand."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/compare", input)
 });
@@ -325,7 +338,8 @@ var aivSentiment = createTool({
     query: queryText("The concise query whose answers are scored for brand sentiment."),
     brand: shortText("The brand to score sentiment for in each model answer."),
     models: modelsInput,
-    fullSweep: fullSweepInput
+    fullSweep: fullSweepInput,
+    ...aiMarketInput
   }),
   execute: async (input) => aivPost("/sentiment", input)
 });
@@ -362,6 +376,24 @@ var aivKeywordsBatch = createTool({
   }),
   execute: async (input) => aivPost("/keywords/batch", input)
 });
+var aivKeywordRankings = createTool({
+  id: "cite42_keyword_rankings",
+  mcp: readOnly("Get Google keyword rankings"),
+  description: `Where a site ranks in Google organic results (top 100) for one to five keywords in one country, desktop or mobile: position, ranking URL, competitor positions, the top 10 and whether the AI Overview cites the site. Billed per keyword checked; a keyword that fails is free. Each check is one live sample. ${PAID_TOOL_BILLING}`,
+  inputSchema: z.object({
+    keywords: z.array(z.string().trim().min(1).max(200)).min(1).max(5).refine(
+      (keywords) => new Set(keywords.map((keyword) => keyword.toLowerCase().replace(/\s+/g, " "))).size === keywords.length,
+      "Keywords must be distinct."
+    ).describe("One to five distinct search terms, as people type them into Google. Each is billed separately."),
+    domain: z.string().trim().max(253).optional().describe("Your site, e.g. example.com. Covers www and subdomains. Omit to get only the top results."),
+    url: z.string().trim().max(500).optional().describe("Optional page that should rank, as a full URL or a path such as /pricing."),
+    competitors: z.array(z.string().trim().min(1).max(253)).max(5).optional().describe("Up to 5 competitor domains to report positions for."),
+    country: z.string().trim().max(8).optional().describe('ISO-2 country code of the Google market to check. Defaults to "us".'),
+    language: z.string().trim().max(8).optional().describe("Optional ISO-2 language code. Defaults to the country's main language."),
+    device: z.enum(["desktop", "mobile"]).optional().describe("Desktop or mobile results. Defaults to desktop.")
+  }),
+  execute: async (input) => aivPost("/keywords/rankings", input)
+});
 var aivTrends = createTool({
   id: "cite42_trends",
   mcp: readOnly("Get Google Trends data"),
@@ -638,6 +670,7 @@ var CITE42_TOOLS = {
   cite42_recommendations: aivRecommendations,
   cite42_keywords: aivKeywords,
   cite42_keywords_batch: aivKeywordsBatch,
+  cite42_keyword_rankings: aivKeywordRankings,
   cite42_trends: aivTrends,
   cite42_reddit_trends: aivRedditTrends,
   cite42_youtube_trends: aivYoutubeTrends,
@@ -673,7 +706,7 @@ if (!resolveApiKey()) {
   );
   process.exit(1);
 }
-buildCite42Server("0.8.2").startStdio().catch((error) => {
+buildCite42Server("0.9.0").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.2",
+  "version": "0.9.0",
   "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",
@@ -26,7 +26,7 @@
   "dependencies": {
     "@mastra/core": "^1.68.0",
     "@mastra/mcp": "^1.18.0",
-    "zod": "^4.4.3"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -83,6 +83,10 @@
   },
   "overrides": {
     "esbuild": "^0.28.2",
-    "@modelcontextprotocol/client": "2.3.1"
+    "@modelcontextprotocol/client": "2.3.1",
+    "@modelcontextprotocol/server": "2.3.1",
+    "@modelcontextprotocol/server-legacy": "2.3.1",
+    "@modelcontextprotocol/node": "2.1.1",
+    "body-parser@^2.0.0": "^2.4.0"
   }
 }