@cite42/mcp 0.1.5 → 0.1.6

package/README.md

@@ -1,111 +1,110 @@
 # @cite42/mcp
 
-Use Cite42 inside Claude Code, Codex CLI, Cursor, and other MCP clients.
+`@cite42/mcp` is a stdio MCP server that exposes Cite42 APIs to your agent.
 
-Cite42 gives your agent market-data tools for:
+Use it to get:
 
-- AI search answers and citations
-- brand rankings, comparisons, and sentiment
-- SEO keywords, CPC, competition, and trends
-- Reddit and YouTube research
-- content, competitor, prompt, and citation-gap workflows
+- AI search answers and citations across major LLM sources
+- Brand ranking and sentiment signals from AI answers
+- SEO keyword, CPC, competition, and search trend data
+- Reddit + YouTube trend and opportunity intelligence
+- End-to-end research workflows (content gaps, topic demand, prompt mapping)
 
-This package is a stdio MCP server. It needs a Cite42 API key.
+## Step-by-step setup
 
-## Install
+1. Create a Cite42 API key
 
-1. Create a Cite42 API key at [cite42.dev/app/keys](https://cite42.dev/app/keys).
+   - Go to: https://cite42.dev/app/keys
+   - Copy your key (format: `cite42_live_...`)
 
-2. Make sure you have Node.js 18 or newer.
+2. Confirm your Node.js version
 
-3. Add the MCP server to your client.
+   - MCP runtime requires Node.js 18 or newer
 
-### Claude Code
+3. Add the MCP server to your client
 
-```bash
-claude mcp add cite42 -e CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
-```
+   - Keep the same command for all clients: `npx -y @cite42/mcp`
+   - Pass your API key using environment variables (recommended)
 
-### Codex CLI
+4. Configure one client
 
-```bash
-codex mcp add cite42 --env CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
-```
+   - Claude Code
 
-### Cursor
+     ```bash
+     claude mcp add cite42 -e CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
+     ```
 
-Add this to your MCP config:
+   - Codex CLI
 
-```json
-{
-  "mcpServers": {
-    "cite42": {
-      "command": "npx",
-      "args": ["-y", "@cite42/mcp"],
-      "env": {
-        "CITE42_API_KEY": "cite42_live_your_key_here"
-      }
-    }
-  }
-}
-```
+     ```bash
+     codex mcp add cite42 --env CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
+     ```
 
-4. Restart your MCP client.
+   - Cursor (`mcpServers` config)
 
-5. Ask your agent to use Cite42, for example:
+     ```json
+     {
+       "mcpServers": {
+         "cite42": {
+           "command": "npx",
+           "args": ["-y", "@cite42/mcp"],
+           "env": {
+             "CITE42_API_KEY": "cite42_live_your_key_here"
+           }
+         }
+       }
+     }
+     ```
 
-```text
-Use Cite42 to check which AI models cite competitors for "best customer support software".
-```
+5. Restart your MCP client
 
-## Endpoints
+6. Try your first request
 
-These MCP tools call the matching Cite42 API endpoints.
+   - Example prompt:
+     `Use Cite42 to find AI-cited competitors for "best project management software".`
 
-### AI Search
+## Available tools
 
-- `cite42_search`: ask ChatGPT, Claude, Perplexity, Gemini, and Google AI Overview a query.
-- `cite42_citations`: see which URLs AI models cite for a query.
-- `cite42_rankings`: check where brands or domains appear in AI answers.
-- `cite42_compare`: compare your brand against competitors.
-- `cite42_sentiment`: measure how AI answers describe a brand.
+- AI search
+  - `cite42_search`
+  - `cite42_citations`
+  - `cite42_rankings`
+  - `cite42_compare`
+  - `cite42_sentiment`
+- SEO and trend intelligence
+  - `cite42_keywords`
+  - `cite42_trends`
+  - `cite42_reddit_trends`
+  - `cite42_youtube_trends`
+- Workflows
+  - `cite42_find_content_opportunities`
+  - `cite42_analyze_topic_demand`
+  - `cite42_map_ai_prompts`
+  - `cite42_analyze_competitor_content`
+  - `cite42_find_ai_citation_gaps`
+  - `cite42_generate_content_brief`
 
-### SEO And Trends
+## Optional configuration
 
-- `cite42_keywords`: get search volume, CPC, competition, competition level, and keyword ideas.
-- `cite42_trends`: get Google Trends interest and rising queries.
-- `cite42_reddit_trends`: find Reddit questions, pain points, threads, and mentioned products.
-- `cite42_youtube_trends`: find YouTube videos, title patterns, creator angles, and opportunities.
+- Required:
 
-### Workflows
+  ```bash
+  CITE42_API_KEY=cite42_live_your_key_here
+  ```
 
-- `cite42_find_content_opportunities`: find content opportunities from AI, SEO, Reddit, YouTube, and trends.
-- `cite42_analyze_topic_demand`: analyze demand for a topic.
-- `cite42_map_ai_prompts`: map buyer prompts worth tracking.
-- `cite42_analyze_competitor_content`: analyze competitor visibility and content coverage.
-- `cite42_find_ai_citation_gaps`: find where competitors get cited but your brand does not.
-- `cite42_generate_content_brief`: generate brief-ready research data.
+- Optional:
 
-## Configuration
+  ```bash
+  CITE42_API_BASE=https://api.cite42.dev/v1
+  ```
 
-1. Required API key:
+- You can also pass flags directly:
 
-```bash
-CITE42_API_KEY=cite42_live_your_key_here
-```
+  ```bash
+  npx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://api.cite42.dev/v1
+  ```
 
-2. Optional custom API base:
+## Billing
 
-```bash
-CITE42_API_BASE=https://api.cite42.dev/v1
-```
+Tool calls consume Cite42 credits. Calls will fail if the API key is missing or credits are insufficient.
 
-You can also pass both as flags:
-
-```bash
-npx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://api.cite42.dev/v1
-```
-
-## Pricing
-
-Tool calls use your Cite42 credits. Without an API key and available credits, calls will fail.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cite42/mcp",
-  "version": "0.1.5",
-  "description": "Stdio MCP server for Cite42 AI search, citations, SEO keywords, trends, and workflows.",
+  "version": "0.1.6",
+  "description": "Bring Cite42 market-research and citation tools into any MCP client (Claude, Codex, Cursor, etc.) with a single npm install.",
   "license": "MIT",
   "type": "module",
   "bin": {