@cite42/mcp 0.1.1 → 0.1.2

package/README.md

@@ -17,7 +17,20 @@ Open your Claude Desktop config:
 - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
-Add the Cite42 MCP server:
+Add the Cite42 MCP server (pass your key as an arg — one flat line):
+
+```json
+{
+  "mcpServers": {
+    "cite42": {
+      "command": "npx",
+      "args": ["-y", "@cite42/mcp", "--api-key=cite42_live_your_key_here"]
+    }
+  }
+}
+```
+
+Prefer an environment variable instead? This form works too:
 
 ```json
 {
@@ -25,15 +38,14 @@ Add the Cite42 MCP server:
     "cite42": {
       "command": "npx",
       "args": ["-y", "@cite42/mcp"],
-      "env": {
-        "CITE42_API_KEY": "cite42_live_your_key_here"
-      }
+      "env": { "CITE42_API_KEY": "cite42_live_your_key_here" }
     }
   }
 }
 ```
 
-Get your API key from [cite42.dev/app/keys](https://cite42.dev/app/keys).
+The same config works in Cursor, Claude Code, VS Code, Windsurf, and Claude Desktop. Get your API
+key from [cite42.dev/app/keys](https://cite42.dev/app/keys).
 
 Restart Claude Desktop. You should see seven new tools available (see below).
 
@@ -60,10 +72,15 @@ Classic keyword data for a seed term: monthly search volume, CPC, competition, a
 ### `cite42_trends`
 Google Trends interest-over-time, related/rising queries, and a rising/falling/stable label for a term.
 
-## Environment variables
+## Configuration
+
+The key (and optional base URL) can be passed as a CLI flag or an environment variable. A flag
+wins when both are set.
 
-- `CITE42_API_KEY` (required) — Your Cite42 API key (`cite42_live_...`)
-- `CITE42_API_BASE` (optional) — Override the API base URL. Defaults to `https://api.cite42.dev/v1`.
+| Setting | Flag | Env var | Default |
+| --- | --- | --- | --- |
+| API key (required) | `--api-key=cite42_live_...` | `CITE42_API_KEY` | — |
+| API base URL | `--api-base=...` | `CITE42_API_BASE` | `https://api.cite42.dev/v1` |
 
 ## Pricing
 

package/dist/stdio.cjs

@@ -10,17 +10,27 @@ var import_zod = require("zod");
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.cite42.dev/v1";
+function readFlag(name) {
+  const argv = process.argv.slice(2);
+  const prefix = `--${name}=`;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith(prefix)) return arg.slice(prefix.length);
+    if (arg === `--${name}` && i + 1 < argv.length) return argv[i + 1];
+  }
+  return void 0;
+}
 function getApiKey() {
-  const key = process.env.CITE42_API_KEY;
+  const key = readFlag("api-key") ?? process.env.CITE42_API_KEY;
   if (!key) {
     throw new Error(
-      "CITE42_API_KEY environment variable is required. Set it in your MCP client config (e.g., Claude Desktop)."
+      "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."
     );
   }
   return key;
 }
 function getBaseUrl() {
-  return process.env.CITE42_API_BASE || DEFAULT_BASE_URL;
+  return readFlag("api-base") ?? process.env.CITE42_API_BASE ?? DEFAULT_BASE_URL;
 }
 async function aivPost(path, body) {
   const url = `${getBaseUrl()}${path.startsWith("/") ? path : `/${path}`}`;

package/dist/stdio.mjs

@@ -9,17 +9,27 @@ import { z } from "zod";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.cite42.dev/v1";
+function readFlag(name) {
+  const argv = process.argv.slice(2);
+  const prefix = `--${name}=`;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith(prefix)) return arg.slice(prefix.length);
+    if (arg === `--${name}` && i + 1 < argv.length) return argv[i + 1];
+  }
+  return void 0;
+}
 function getApiKey() {
-  const key = process.env.CITE42_API_KEY;
+  const key = readFlag("api-key") ?? process.env.CITE42_API_KEY;
   if (!key) {
     throw new Error(
-      "CITE42_API_KEY environment variable is required. Set it in your MCP client config (e.g., Claude Desktop)."
+      "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."
     );
   }
   return key;
 }
 function getBaseUrl() {
-  return process.env.CITE42_API_BASE || DEFAULT_BASE_URL;
+  return readFlag("api-base") ?? process.env.CITE42_API_BASE ?? DEFAULT_BASE_URL;
 }
 async function aivPost(path, body) {
   const url = `${getBaseUrl()}${path.startsWith("/") ? path : `/${path}`}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cite42/mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP server for the Cite42 AI search data API. Use Claude Desktop and other LLM clients to query AI search engines.",
   "license": "MIT",
   "type": "module",