@cite42/mcp 0.1.4 → 0.1.5

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 +78 -34
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,29 +1,38 @@
1
1
  # @cite42/mcp
2
2
 
3
- Stdio MCP server for [Cite42](https://cite42.dev).
3
+ Use Cite42 inside Claude Code, Codex CLI, Cursor, and other MCP clients.
4
4
 
5
- Use Cite42 from your coding agent to:
5
+ Cite42 gives your agent market-data tools for:
6
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
7
+ - AI search answers and citations
8
+ - brand rankings, comparisons, and sentiment
9
+ - SEO keywords, CPC, competition, and trends
10
+ - Reddit and YouTube research
11
+ - content, competitor, prompt, and citation-gap workflows
11
12
 
12
- Requires a Cite42 API key from [cite42.dev/app/keys](https://cite42.dev/app/keys).
13
+ This package is a stdio MCP server. It needs a Cite42 API key.
13
14
 
14
- ## Claude Code
15
+ ## Install
16
+
17
+ 1. Create a Cite42 API key at [cite42.dev/app/keys](https://cite42.dev/app/keys).
18
+
19
+ 2. Make sure you have Node.js 18 or newer.
20
+
21
+ 3. Add the MCP server to your client.
22
+
23
+ ### Claude Code
15
24
 
16
25
  ```bash
17
26
  claude mcp add cite42 -e CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
18
27
  ```
19
28
 
20
- ## Codex CLI
29
+ ### Codex CLI
21
30
 
22
31
  ```bash
23
32
  codex mcp add cite42 --env CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
24
33
  ```
25
34
 
26
- ## Cursor
35
+ ### Cursor
27
36
 
28
37
  Add this to your MCP config:
29
38
 
@@ -41,27 +50,62 @@ Add this to your MCP config:
41
50
  }
42
51
  ```
43
52
 
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://...`
53
+ 4. Restart your MCP client.
54
+
55
+ 5. Ask your agent to use Cite42, for example:
56
+
57
+ ```text
58
+ Use Cite42 to check which AI models cite competitors for "best customer support software".
59
+ ```
60
+
61
+ ## Endpoints
62
+
63
+ These MCP tools call the matching Cite42 API endpoints.
64
+
65
+ ### AI Search
66
+
67
+ - `cite42_search`: ask ChatGPT, Claude, Perplexity, Gemini, and Google AI Overview a query.
68
+ - `cite42_citations`: see which URLs AI models cite for a query.
69
+ - `cite42_rankings`: check where brands or domains appear in AI answers.
70
+ - `cite42_compare`: compare your brand against competitors.
71
+ - `cite42_sentiment`: measure how AI answers describe a brand.
72
+
73
+ ### SEO And Trends
74
+
75
+ - `cite42_keywords`: get search volume, CPC, competition, competition level, and keyword ideas.
76
+ - `cite42_trends`: get Google Trends interest and rising queries.
77
+ - `cite42_reddit_trends`: find Reddit questions, pain points, threads, and mentioned products.
78
+ - `cite42_youtube_trends`: find YouTube videos, title patterns, creator angles, and opportunities.
79
+
80
+ ### Workflows
81
+
82
+ - `cite42_find_content_opportunities`: find content opportunities from AI, SEO, Reddit, YouTube, and trends.
83
+ - `cite42_analyze_topic_demand`: analyze demand for a topic.
84
+ - `cite42_map_ai_prompts`: map buyer prompts worth tracking.
85
+ - `cite42_analyze_competitor_content`: analyze competitor visibility and content coverage.
86
+ - `cite42_find_ai_citation_gaps`: find where competitors get cited but your brand does not.
87
+ - `cite42_generate_content_brief`: generate brief-ready research data.
88
+
89
+ ## Configuration
90
+
91
+ 1. Required API key:
92
+
93
+ ```bash
94
+ CITE42_API_KEY=cite42_live_your_key_here
95
+ ```
96
+
97
+ 2. Optional custom API base:
98
+
99
+ ```bash
100
+ CITE42_API_BASE=https://api.cite42.dev/v1
101
+ ```
102
+
103
+ You can also pass both as flags:
104
+
105
+ ```bash
106
+ npx -y @cite42/mcp --api-key=cite42_live_your_key_here --api-base=https://api.cite42.dev/v1
107
+ ```
108
+
109
+ ## Pricing
110
+
111
+ Tool calls use your Cite42 credits. Without an API key and available credits, calls will fail.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cite42/mcp",
3
- "version": "0.1.4",
3
+ "version": "0.1.5",
4
4
  "description": "Stdio MCP server for Cite42 AI search, citations, SEO keywords, trends, and workflows.",
5
5
  "license": "MIT",
6
6
  "type": "module",