@cite42/mcp 0.1.4 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +108 -65
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,67 +1,110 @@
1
1
  # @cite42/mcp
2
2
 
3
- Stdio MCP server for [Cite42](https://cite42.dev).
4
-
5
- Use Cite42 from your coding agent to:
6
-
7
- - check AI search answers across ChatGPT, Claude, Perplexity, Gemini, and Google AI Overview
8
- - find citations, rankings, brand comparisons, and sentiment
9
- - get SEO keyword data, Google Trends, Reddit trends, and YouTube trends
10
- - run Cite42 workflows for content, demand, prompts, competitors, and citation gaps
11
-
12
- Requires a Cite42 API key from [cite42.dev/app/keys](https://cite42.dev/app/keys).
13
-
14
- ## Claude Code
15
-
16
- ```bash
17
- claude mcp add cite42 -e CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
18
- ```
19
-
20
- ## Codex CLI
21
-
22
- ```bash
23
- codex mcp add cite42 --env CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
24
- ```
25
-
26
- ## Cursor
27
-
28
- Add this to your MCP config:
29
-
30
- ```json
31
- {
32
- "mcpServers": {
33
- "cite42": {
34
- "command": "npx",
35
- "args": ["-y", "@cite42/mcp"],
36
- "env": {
37
- "CITE42_API_KEY": "cite42_live_your_key_here"
38
- }
39
- }
40
- }
41
- }
42
- ```
43
-
44
- ## Tools
45
-
46
- - `cite42_search`
47
- - `cite42_citations`
48
- - `cite42_rankings`
49
- - `cite42_compare`
50
- - `cite42_sentiment`
51
- - `cite42_keywords`
52
- - `cite42_trends`
53
- - `cite42_reddit_trends`
54
- - `cite42_youtube_trends`
55
- - `cite42_find_content_opportunities`
56
- - `cite42_analyze_topic_demand`
57
- - `cite42_map_ai_prompts`
58
- - `cite42_analyze_competitor_content`
59
- - `cite42_find_ai_citation_gaps`
60
- - `cite42_generate_content_brief`
61
-
62
- ## Notes
63
-
64
- - This package uses stdio MCP.
65
- - Tool calls use your Cite42 credits.
66
- - No API key means no successful tool calls.
67
- - Optional base URL: `CITE42_API_BASE` or `--api-base=https://...`
3
+ `@cite42/mcp` is a stdio MCP server that exposes Cite42 APIs to your agent.
4
+
5
+ Use it to get:
6
+
7
+ - AI search answers and citations across major LLM sources
8
+ - Brand ranking and sentiment signals from AI answers
9
+ - SEO keyword, CPC, competition, and search trend data
10
+ - Reddit + YouTube trend and opportunity intelligence
11
+ - End-to-end research workflows (content gaps, topic demand, prompt mapping)
12
+
13
+ ## Step-by-step setup
14
+
15
+ 1. Create a Cite42 API key
16
+
17
+ - Go to: https://cite42.dev/app/keys
18
+ - Copy your key (format: `cite42_live_...`)
19
+
20
+ 2. Confirm your Node.js version
21
+
22
+ - MCP runtime requires Node.js 18 or newer
23
+
24
+ 3. Add the MCP server to your client
25
+
26
+ - Keep the same command for all clients: `npx -y @cite42/mcp`
27
+ - Pass your API key using environment variables (recommended)
28
+
29
+ 4. Configure one client
30
+
31
+ - Claude Code
32
+
33
+ ```bash
34
+ claude mcp add cite42 -e CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
35
+ ```
36
+
37
+ - Codex CLI
38
+
39
+ ```bash
40
+ codex mcp add cite42 --env CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
41
+ ```
42
+
43
+ - Cursor (`mcpServers` config)
44
+
45
+ ```json
46
+ {
47
+ "mcpServers": {
48
+ "cite42": {
49
+ "command": "npx",
50
+ "args": ["-y", "@cite42/mcp"],
51
+ "env": {
52
+ "CITE42_API_KEY": "cite42_live_your_key_here"
53
+ }
54
+ }
55
+ }
56
+ }
57
+ ```
58
+
59
+ 5. Restart your MCP client
60
+
61
+ 6. Try your first request
62
+
63
+ - Example prompt:
64
+ `Use Cite42 to find AI-cited competitors for "best project management software".`
65
+
66
+ ## Available tools
67
+
68
+ - AI search
69
+ - `cite42_search`
70
+ - `cite42_citations`
71
+ - `cite42_rankings`
72
+ - `cite42_compare`
73
+ - `cite42_sentiment`
74
+ - SEO and trend intelligence
75
+ - `cite42_keywords`
76
+ - `cite42_trends`
77
+ - `cite42_reddit_trends`
78
+ - `cite42_youtube_trends`
79
+ - Workflows
80
+ - `cite42_find_content_opportunities`
81
+ - `cite42_analyze_topic_demand`
82
+ - `cite42_map_ai_prompts`
83
+ - `cite42_analyze_competitor_content`
84
+ - `cite42_find_ai_citation_gaps`
85
+ - `cite42_generate_content_brief`
86
+
87
+ ## Optional configuration
88
+
89
+ - Required:
90
+
91
+ ```bash
92
+ CITE42_API_KEY=cite42_live_your_key_here
93
+ ```
94
+
95
+ - Optional:
96
+
97
+ ```bash
98
+ CITE42_API_BASE=https://api.cite42.dev/v1
99
+ ```
100
+
101
+ - You can also pass flags directly:
102
+
103
+ ```bash
104
+ npx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://api.cite42.dev/v1
105
+ ```
106
+
107
+ ## Billing
108
+
109
+ Tool calls consume Cite42 credits. Calls will fail if the API key is missing or credits are insufficient.
110
+
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@cite42/mcp",
3
- "version": "0.1.4",
4
- "description": "Stdio MCP server for Cite42 AI search, citations, SEO keywords, trends, and workflows.",
3
+ "version": "0.1.6",
4
+ "description": "Bring Cite42 market-research and citation tools into any MCP client (Claude, Codex, Cursor, etc.) with a single npm install.",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "bin": {