@cite42/mcp 0.1.12 → 0.1.14

package/README.md

@@ -72,6 +72,8 @@ MCP servers are started by the client, so the config is only picked up on a fres
 - **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
 
+You do not need to keep `npx -y @cite42/mcp` running in a separate terminal. The MCP client starts it automatically when the session needs tools.
+
 ### Step 4: Verify it's running
 
 - **Claude Code:** run `claude mcp list` and check that `cite42` shows as ✔ connected. Or type `/mcp` inside a session.
@@ -107,49 +109,43 @@ After restarting, just ask in plain language. Your agent picks the right Cite42
 >
 > 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
+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.
+
+## Endpoint tools
 
 ### AI search visibility
 
-| Tool | What it does |
-| --- | --- |
-| `cite42_search` | Run a query against ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews; returns each model's answer plus cited sources |
-| `cite42_citations` | Aggregate which URLs the AI models cite for a query; optionally check if a specific URL is cited |
-| `cite42_rankings` | Measure how brands rank in AI answers: mention rate, average position, per-model breakdown |
-| `cite42_compare` | Head-to-head brand comparison in AI answers, including a co-mention graph |
-| `cite42_sentiment` | Positive/neutral/negative sentiment per model for a brand, with the verbatim phrases driving it |
+- `cite42_search`: run a query against ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews. Returns each model's answer plus cited sources.
+- `cite42_citations`: aggregate which URLs the AI models cite for a query. Can also check whether a specific URL is cited.
+- `cite42_rankings`: measure how brands rank in AI answers, including mention rate, average position, and per-model breakdown.
+- `cite42_compare`: compare one brand against competitors in AI answers.
+- `cite42_sentiment`: score positive, neutral, and negative sentiment for a brand, with supporting phrases.
 
 ### SEO & trend data
 
-| Tool | What it does |
-| --- | --- |
-| `cite42_keywords` | Search volume, CPC, competition, and related keyword ideas for a seed term |
-| `cite42_trends` | Google Trends interest over time, related/rising queries, rising/falling label |
-| `cite42_reddit_trends` | Audience questions, pain points, rising threads, and product mentions on Reddit |
-| `cite42_youtube_trends` | Rising videos, creator angles, title patterns, and opportunities on YouTube |
+- `cite42_keywords`: get search volume, CPC, competition, competition level, and related keyword ideas.
+- `cite42_trends`: get Google Trends interest over time, related and rising queries, and a trend label.
+- `cite42_reddit_trends`: find Reddit audience questions, pain points, rising threads, and product mentions.
+- `cite42_youtube_trends`: find YouTube rising videos, creator angles, title patterns, and opportunities.
 
 ### Research workflows (multi-source, one call)
 
-| Tool | What it does |
-| --- | --- |
-| `cite42_find_content_opportunities` | Content gaps across AI search, keywords, trends, Reddit, YouTube, and citations |
-| `cite42_analyze_topic_demand` | Keyword data + trends + AI answers + audience conversations for a topic |
-| `cite42_map_ai_prompts` | Discover and cluster the buyer prompts worth tracking in AI search |
-| `cite42_analyze_competitor_content` | AI rankings, comparisons, citations, and topic coverage for a competitor |
-| `cite42_find_ai_citation_gaps` | Queries where AI answers cite others but not your brand/domain/URL |
-| `cite42_generate_content_brief` | AI answers, citations, keyword demand, and social signals aggregated into a brief |
+- `cite42_find_content_opportunities`: find content gaps across AI search, keywords, trends, Reddit, YouTube, and citations.
+- `cite42_analyze_topic_demand`: combine keyword data, trends, AI answers, and audience conversations for a topic.
+- `cite42_map_ai_prompts`: discover and cluster buyer prompts worth tracking in AI search.
+- `cite42_analyze_competitor_content`: analyze AI rankings, comparisons, citations, and topic coverage for competitors.
+- `cite42_find_ai_citation_gaps`: find queries where AI answers cite competitors but not your brand, domain, or URL.
+- `cite42_generate_content_brief`: collect AI answers, citations, keyword demand, and social signals into brief-ready data.
 
 ## Configuration
 
-| Variable | Required | Default | Description |
-| --- | --- | --- | --- |
-| `CITE42_API_KEY` | Yes | (none) | Your API key from [www.cite42.dev/app/keys](https://www.cite42.dev/app/keys) |
-| `CITE42_API_BASE` | No | `https://api.www.cite42.dev/v1` | Override the API base URL |
+- `CITE42_API_KEY`: required. Your API key from [www.cite42.dev/app/keys](https://www.cite42.dev/app/keys).
+- `CITE42_API_BASE`: optional. Defaults to `https://www.cite42.dev/api/v1`.
 
 You can also pass these as CLI flags instead of environment variables:
 
 ```bash
-npx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://api.www.cite42.dev/v1
+npx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://www.cite42.dev/api/v1
 ```
 
 ## Billing

package/dist/stdio.cjs

@@ -5,7 +5,7 @@
 var import_mcp = require("@mastra/mcp");
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.www.cite42.dev/v1";
+var DEFAULT_BASE_URL = "https://www.cite42.dev/api/v1";
 function readFlag(name) {
   const argv = process.argv.slice(2);
   const prefix = `--${name}=`;
@@ -243,7 +243,7 @@ if (!resolveApiKey()) {
 var server = new import_mcp.MCPServer({
   id: "cite42",
   name: "Cite42",
-  version: "0.1.12",
+  version: "0.1.14",
   description: "AI market data API: AI search, citations, SEO keywords, trends, and workflows.",
   tools: {
     cite42_search: aivSearch,

package/dist/stdio.mjs

@@ -4,7 +4,7 @@
 import { MCPServer } from "@mastra/mcp";
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.www.cite42.dev/v1";
+var DEFAULT_BASE_URL = "https://www.cite42.dev/api/v1";
 function readFlag(name) {
   const argv = process.argv.slice(2);
   const prefix = `--${name}=`;
@@ -242,7 +242,7 @@ if (!resolveApiKey()) {
 var server = new MCPServer({
   id: "cite42",
   name: "Cite42",
-  version: "0.1.12",
+  version: "0.1.14",
   description: "AI market data API: AI search, citations, SEO keywords, trends, and workflows.",
   tools: {
     cite42_search: aivSearch,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cite42/mcp",
   "mcpName": "dev.cite42/mcp",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "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",