@cite42/mcp 0.1.7 → 0.1.9

package/README.md

@@ -1,33 +1,33 @@
 # @cite42/mcp
 
-MCP server for [Cite42](https://cite42.dev) — AI search visibility, SEO keywords, and trend research tools for your AI agent.
+MCP server for [Cite42](https://cite42.dev): AI search visibility, SEO keywords, and trend research tools for your AI agent.
 
 Once installed, your MCP client (Claude Code, Claude Desktop, Codex CLI, Cursor, Windsurf, etc.) 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
+- **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
+- **Run full research workflows**: content gaps, topic demand, AI prompt maps, competitor analysis, and content briefs in a single call
 
 ---
 
 ## Requirements
 
 - **Node.js 18 or newer** (`node --version` to check)
-- **A Cite42 API key** — free to create at [cite42.dev/app/keys](https://cite42.dev/app/keys)
+- **A Cite42 API key**, free to create at [cite42.dev/app/keys](https://cite42.dev/app/keys)
 
 ## Installation
 
-There is nothing to install manually — every client below runs the server on demand with `npx -y @cite42/mcp`. You only need to register it once.
+There is nothing to install manually. Every client below runs the server on demand with `npx -y @cite42/mcp`. You only need to register it once.
 
-### Step 1 — Get your API key
+### Step 1: Get your API key
 
 1. Sign in at [cite42.dev](https://cite42.dev)
 2. Open **Dashboard → API Keys**: [cite42.dev/app/keys](https://cite42.dev/app/keys)
 3. Create a key and copy it (it looks like `cite42_live_...`)
 
-### Step 2 — Add the server to your client
+### Step 2: Add the server to your client
 
 Pick **one** of the clients below and replace `cite42_live_your_key_here` with your real key.
 
@@ -65,22 +65,22 @@ Add this to `claude_desktop_config.json` (**Settings → Developer → Edit Conf
 
 Use the same JSON block as Claude Desktop in your client's `mcpServers` config (Cursor: `~/.cursor/mcp.json` or **Settings → MCP**).
 
-### Step 3 — Restart so the server loads
+### Step 3: Restart so the server loads
 
 MCP servers are started by the client, so the config is only picked up on a fresh start:
 
-- **Claude Code / Codex CLI** — exit the current session and open a **new terminal** (or start a new `claude` / `codex` session)
-- **Claude Desktop / Cursor / Windsurf** — fully quit and reopen the app
+- **Claude Code / Codex CLI**: exit the current session and open a **new terminal** (or start a new `claude` / `codex` session)
+- **Claude Desktop / Cursor / Windsurf**: fully quit and reopen the app
 
-### Step 4 — Verify it's running
+### Step 4: Verify it's running
 
-- **Claude Code:** run `claude mcp list` — `cite42` should show as ✔ connected. Or type `/mcp` inside a session.
+- **Claude Code:** run `claude mcp list` and check that `cite42` shows as ✔ connected. Or type `/mcp` inside a session.
 - **Codex CLI:** run `codex mcp list`.
-- **Claude Desktop / Cursor:** look for `cite42` in the MCP/tools indicator — 15 tools should be listed.
+- **Claude Desktop / Cursor:** look for `cite42` in the MCP/tools indicator. 15 tools should be listed.
 
 If it doesn't appear, see [Troubleshooting](#troubleshooting).
 
-## Try it — example prompts
+## Try it: example prompts
 
 After restarting, just ask in plain language. Your agent picks the right Cite42 tool automatically.
 
@@ -100,12 +100,12 @@ After restarting, just ask in plain language. Your agent picks the right Cite42
 
 > Across ChatGPT, Claude, Perplexity, and Gemini, the most-cited sources are:
 >
-> 1. **freshbooks.com** — cited by 4/5 models
-> 2. **wave.com** — cited by 3/5 models
-> 3. **zoho.com/invoice** — cited by 3/5 models
-> 4. **bonsai.com** — cited by 2/5 models
+> 1. **freshbooks.com** (cited by 4/5 models)
+> 2. **wave.com** (cited by 3/5 models)
+> 3. **zoho.com/invoice** (cited by 3/5 models)
+> 4. **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.
+> 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.
 
 ## Available tools
 
@@ -143,7 +143,7 @@ After restarting, just ask in plain language. Your agent picks the right Cite42
 
 | Variable | Required | Default | Description |
 | --- | --- | --- | --- |
-| `CITE42_API_KEY` | Yes | — | Your API key from [cite42.dev/app/keys](https://cite42.dev/app/keys) |
+| `CITE42_API_KEY` | Yes | (none) | Your API key from [cite42.dev/app/keys](https://cite42.dev/app/keys) |
 | `CITE42_API_BASE` | No | `https://api.cite42.dev/v1` | Override the API base URL |
 
 You can also pass these as CLI flags instead of environment variables:
@@ -158,10 +158,10 @@ Tool calls consume Cite42 credits from your account. Calls fail with a clear err
 
 ## 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](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 [cite42.dev/app/keys](https://cite42.dev/app/keys).
-- **Tool calls fail with a credits error** — top up credits at [cite42.dev/app](https://cite42.dev/app).
+- **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](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 [cite42.dev/app/keys](https://cite42.dev/app/keys).
+- **Tool calls fail with a credits error**: top up credits at [cite42.dev/app](https://cite42.dev/app).
 
 ## Links
 

package/dist/stdio.cjs

@@ -4,10 +4,6 @@
 // src/stdio.ts
 var import_mcp = require("@mastra/mcp");
 
-// src/tools.ts
-var import_tools = require("@mastra/core/tools");
-var import_zod = require("zod");
-
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.cite42.dev/v1";
 function readFlag(name) {
@@ -20,8 +16,11 @@ function readFlag(name) {
   }
   return void 0;
 }
+function resolveApiKey() {
+  return readFlag("api-key") ?? process.env.CITE42_API_KEY;
+}
 function getApiKey() {
-  const key = readFlag("api-key") ?? process.env.CITE42_API_KEY;
+  const key = resolveApiKey();
   if (!key) {
     throw new Error(
       "No Cite42 API key found. Pass --api-key=cite42_live_... in the server args, or set the CITE42_API_KEY environment variable in your MCP client config."
@@ -50,6 +49,8 @@ async function aivPost(path, body) {
 }
 
 // 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 QUERY_MAX_CHARS = 2e3;
 var SHORT_TEXT_MAX_CHARS = 200;
@@ -233,6 +234,12 @@ var aivGenerateContentBrief = (0, import_tools.createTool)({
 });
 
 // src/stdio.ts
+if (!resolveApiKey()) {
+  console.error(
+    "[@cite42/mcp] Missing API key. Set CITE42_API_KEY in your MCP client config (or pass --api-key=cite42_live_...). Get a key at https://cite42.dev/app/keys. Setup guide: https://www.npmjs.com/package/@cite42/mcp"
+  );
+  process.exit(1);
+}
 var server = new import_mcp.MCPServer({
   id: "cite42",
   name: "Cite42",

package/dist/stdio.mjs

@@ -3,10 +3,6 @@
 // src/stdio.ts
 import { MCPServer } from "@mastra/mcp";
 
-// src/tools.ts
-import { createTool } from "@mastra/core/tools";
-import { z } from "zod";
-
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.cite42.dev/v1";
 function readFlag(name) {
@@ -19,8 +15,11 @@ function readFlag(name) {
   }
   return void 0;
 }
+function resolveApiKey() {
+  return readFlag("api-key") ?? process.env.CITE42_API_KEY;
+}
 function getApiKey() {
-  const key = readFlag("api-key") ?? process.env.CITE42_API_KEY;
+  const key = resolveApiKey();
   if (!key) {
     throw new Error(
       "No Cite42 API key found. Pass --api-key=cite42_live_... in the server args, or set the CITE42_API_KEY environment variable in your MCP client config."
@@ -49,6 +48,8 @@ async function aivPost(path, body) {
 }
 
 // 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 QUERY_MAX_CHARS = 2e3;
 var SHORT_TEXT_MAX_CHARS = 200;
@@ -232,6 +233,12 @@ var aivGenerateContentBrief = createTool({
 });
 
 // src/stdio.ts
+if (!resolveApiKey()) {
+  console.error(
+    "[@cite42/mcp] Missing API key. Set CITE42_API_KEY in your MCP client config (or pass --api-key=cite42_live_...). Get a key at https://cite42.dev/app/keys. Setup guide: https://www.npmjs.com/package/@cite42/mcp"
+  );
+  process.exit(1);
+}
 var server = new MCPServer({
   id: "cite42",
   name: "Cite42",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cite42/mcp",
-  "version": "0.1.7",
-  "description": "Cite42 MCP server: query ChatGPT, Claude, Perplexity, Gemini & Google AI Overviews for brand rankings, AI citations, SEO keyword data, and Reddit/YouTube trends — works with Claude Code, Claude Desktop, Codex CLI, Cursor, and any MCP client.",
+  "version": "0.1.9",
+  "description": "Cite42 MCP server: query ChatGPT, Claude, Perplexity, Gemini & Google AI Overviews for brand rankings, AI citations, SEO keyword data, and Reddit/YouTube trends. Works with Claude Code, Claude Desktop, Codex CLI, Cursor, and any MCP client.",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -29,7 +29,16 @@
   "publishConfig": {
     "access": "public"
   },
-  "keywords": ["mcp", "model-context-protocol", "cite42", "ai-search", "seo", "keywords", "trends", "claude"],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cite42",
+    "ai-search",
+    "seo",
+    "keywords",
+    "trends",
+    "claude"
+  ],
   "engines": {
     "node": ">=18"
   }