@cite42/mcp 0.8.3 → 0.9.1

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

@@ -141,11 +141,11 @@ var import_mcp = require("@mastra/mcp");
 // src/tools.ts
 var import_tools = require("@mastra/core/tools");
 var import_zod = require("zod");
-var modelEnum = import_zod.z.enum(["chatgpt", "claude", "perplexity", "gemini", "google_ai_overview"]);
+var modelEnum = import_zod.z.enum(["chatgpt", "claude", "perplexity", "gemini", "google_ai_overview", "chatgpt_app"]);
 var QUERY_MAX_CHARS = 2e3;
 var SHORT_TEXT_MAX_CHARS = 200;
 var TIMEFRAME_MAX_CHARS = 80;
-var MODEL_SELECTION_DESCRIPTION = "AI surfaces to query, each billed separately; pass a subset when the user names surfaces or wants a lower cost. Omit for the defaults (chatgpt, perplexity, gemini); fullSweep queries all five. google_ai_overview accepts queries up to 700 characters, the others 2000.";
+var MODEL_SELECTION_DESCRIPTION = "AI surfaces to query, each billed separately; pass a subset when the user names surfaces or wants a lower cost. Omit for the defaults (chatgpt, perplexity, gemini); fullSweep queries all five. google_ai_overview accepts queries up to 700 characters, the others 2000. chatgpt_app (answers captured from the ChatGPT app itself) is opt-in and runs in trackers only for now.";
 var FULL_SWEEP_DESCRIPTION = "Query all five AI surfaces (adds claude and google_ai_overview) for full cross-surface coverage, at a higher cost. Ignored when models is given.";
 var PAID_TOOL_BILLING = "Billed in USD (result field cite42Billing) to the user's prepaid Cite42 balance; exact prices from cite42_pricing (free). For plans over 20 calls or $5, estimate the cost and confirm with the user first.";
 var RECOMMENDATIONS_INPUT_NOTE = "Its requestId can be passed to cite42_recommendations when the user asks for improvement advice.";
@@ -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"),
@@ -546,7 +578,7 @@ var trackerDefinitionFields = {
   ),
   url: import_zod.z.string().trim().min(1).max(500).nullish().describe("Citations only: a URL to report on as cited or not cited."),
   models: import_zod.z.array(modelEnum).nonempty().nullish().describe(
-    "AI surfaces to query for every prompt. Omit for the three defaults (chatgpt, perplexity, gemini), or list surfaces explicitly \u2014 including all five \u2014 to fix the recurring cost."
+    "AI surfaces to query for every prompt. Omit for the three defaults (chatgpt, perplexity, gemini), or list surfaces explicitly to set the recurring cost; chatgpt_app (the ChatGPT app itself) is opt-in. There is no fullSweep here: a saved tracker stores the exact list it was authorized for."
   )
 };
 var TRACKER_BILLING_DESCRIPTION = "Managing trackers and reading reports is free; each run bills one call per prompt at the per-surface rates.";
@@ -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.3").startStdio().catch((error) => {
+buildCite42Server("0.9.1").startStdio().catch((error) => {
   console.error("[@cite42/mcp] Fatal error:", error);
   process.exit(1);
 });

package/dist/stdio.mjs

@@ -140,11 +140,11 @@ import { MCPServer } from "@mastra/mcp";
 // src/tools.ts
 import { createTool } from "@mastra/core/tools";
 import { z } from "zod";
-var modelEnum = z.enum(["chatgpt", "claude", "perplexity", "gemini", "google_ai_overview"]);
+var modelEnum = z.enum(["chatgpt", "claude", "perplexity", "gemini", "google_ai_overview", "chatgpt_app"]);
 var QUERY_MAX_CHARS = 2e3;
 var SHORT_TEXT_MAX_CHARS = 200;
 var TIMEFRAME_MAX_CHARS = 80;
-var MODEL_SELECTION_DESCRIPTION = "AI surfaces to query, each billed separately; pass a subset when the user names surfaces or wants a lower cost. Omit for the defaults (chatgpt, perplexity, gemini); fullSweep queries all five. google_ai_overview accepts queries up to 700 characters, the others 2000.";
+var MODEL_SELECTION_DESCRIPTION = "AI surfaces to query, each billed separately; pass a subset when the user names surfaces or wants a lower cost. Omit for the defaults (chatgpt, perplexity, gemini); fullSweep queries all five. google_ai_overview accepts queries up to 700 characters, the others 2000. chatgpt_app (answers captured from the ChatGPT app itself) is opt-in and runs in trackers only for now.";
 var FULL_SWEEP_DESCRIPTION = "Query all five AI surfaces (adds claude and google_ai_overview) for full cross-surface coverage, at a higher cost. Ignored when models is given.";
 var PAID_TOOL_BILLING = "Billed in USD (result field cite42Billing) to the user's prepaid Cite42 balance; exact prices from cite42_pricing (free). For plans over 20 calls or $5, estimate the cost and confirm with the user first.";
 var RECOMMENDATIONS_INPUT_NOTE = "Its requestId can be passed to cite42_recommendations when the user asks for improvement advice.";
@@ -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"),
@@ -545,7 +577,7 @@ var trackerDefinitionFields = {
   ),
   url: z.string().trim().min(1).max(500).nullish().describe("Citations only: a URL to report on as cited or not cited."),
   models: z.array(modelEnum).nonempty().nullish().describe(
-    "AI surfaces to query for every prompt. Omit for the three defaults (chatgpt, perplexity, gemini), or list surfaces explicitly \u2014 including all five \u2014 to fix the recurring cost."
+    "AI surfaces to query for every prompt. Omit for the three defaults (chatgpt, perplexity, gemini), or list surfaces explicitly to set the recurring cost; chatgpt_app (the ChatGPT app itself) is opt-in. There is no fullSweep here: a saved tracker stores the exact list it was authorized for."
   )
 };
 var TRACKER_BILLING_DESCRIPTION = "Managing trackers and reading reports is free; each run bills one call per prompt at the per-surface rates.";
@@ -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.3").startStdio().catch((error) => {
+buildCite42Server("0.9.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.3",
+  "version": "0.9.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",
@@ -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",
@@ -86,6 +86,7 @@
     "@modelcontextprotocol/client": "2.3.1",
     "@modelcontextprotocol/server": "2.3.1",
     "@modelcontextprotocol/server-legacy": "2.3.1",
-    "@modelcontextprotocol/node": "2.1.1"
+    "@modelcontextprotocol/node": "2.1.1",
+    "body-parser@^2.0.0": "^2.4.0"
   }
 }