@cite42/mcp 0.1.3 → 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 +67 -112
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,52 +1,40 @@
1
1
  # @cite42/mcp
2
2
 
3
- MCP (Model Context Protocol) server for the [Cite42](https://cite42.dev) API, built on
4
- [Mastra](https://mastra.ai).
3
+ Use Cite42 inside Claude Code, Codex CLI, Cursor, and other MCP clients.
5
4
 
6
- Cite42 lets Claude Desktop, Cursor, Claude Code, VS Code, Windsurf, and other MCP clients query
7
- AI-search visibility, citations, SEO keyword data, Google Trends, Reddit/YouTube signals, and
8
- creator/agency workflow contracts.
5
+ Cite42 gives your agent market-data tools for:
9
6
 
10
- This package is a thin MCP client. It forwards tool calls to the hosted Cite42 REST API, so billing,
11
- metering, provider keys, caching, and rate limits stay server-side.
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
12
12
 
13
- ## Requirements
14
-
15
- - Node.js 18 or newer
16
- - A Cite42 API key
17
- - Prepaid Cite42 credits
18
-
19
- Get an API key from [cite42.dev/app/keys](https://cite42.dev/app/keys). Top up credits at
20
- [cite42.dev/app/billing](https://cite42.dev/app/billing).
21
-
22
- Without an API key, the MCP server starts but tool calls cannot reach the Cite42 API.
13
+ This package is a stdio MCP server. It needs a Cite42 API key.
23
14
 
24
15
  ## Install
25
16
 
26
- You do not need to install this package globally. Use `npx`; your MCP client will fetch and run the
27
- latest published version.
17
+ 1. Create a Cite42 API key at [cite42.dev/app/keys](https://cite42.dev/app/keys).
28
18
 
29
- ## Configure Claude Desktop
19
+ 2. Make sure you have Node.js 18 or newer.
30
20
 
31
- Open your Claude Desktop config:
21
+ 3. Add the MCP server to your client.
32
22
 
33
- - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
34
- - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
23
+ ### Claude Code
35
24
 
36
- Add the Cite42 MCP server:
25
+ ```bash
26
+ claude mcp add cite42 -e CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
27
+ ```
37
28
 
38
- ```json
39
- {
40
- "mcpServers": {
41
- "cite42": {
42
- "command": "npx",
43
- "args": ["-y", "@cite42/mcp", "--api-key=cite42_live_your_key_here"]
44
- }
45
- }
46
- }
29
+ ### Codex CLI
30
+
31
+ ```bash
32
+ codex mcp add cite42 --env CITE42_API_KEY=cite42_live_your_key_here -- npx -y @cite42/mcp
47
33
  ```
48
34
 
49
- You can also pass the key as an environment variable:
35
+ ### Cursor
36
+
37
+ Add this to your MCP config:
50
38
 
51
39
  ```json
52
40
  {
@@ -54,103 +42,70 @@ You can also pass the key as an environment variable:
54
42
  "cite42": {
55
43
  "command": "npx",
56
44
  "args": ["-y", "@cite42/mcp"],
57
- "env": { "CITE42_API_KEY": "cite42_live_your_key_here" }
45
+ "env": {
46
+ "CITE42_API_KEY": "cite42_live_your_key_here"
47
+ }
58
48
  }
59
49
  }
60
50
  }
61
51
  ```
62
52
 
63
- Restart your MCP client after editing the config.
53
+ 4. Restart your MCP client.
64
54
 
65
- ## Configuration
66
-
67
- | Setting | Flag | Env var | Default |
68
- | --- | --- | --- | --- |
69
- | API key | `--api-key=cite42_live_...` | `CITE42_API_KEY` | Required |
70
- | API base URL | `--api-base=...` | `CITE42_API_BASE` | `https://api.cite42.dev/v1` |
71
-
72
- Flags win over environment variables when both are set.
73
-
74
- ## Tools
75
-
76
- | Tool | What it does |
77
- | --- | --- |
78
- | `cite42_search` | Runs a query across ChatGPT, Claude, Perplexity, Gemini, and Google AI Overview, returning answers and cited sources. |
79
- | `cite42_citations` | Aggregates cited URLs for a query and can check whether a specific URL is cited. |
80
- | `cite42_rankings` | Measures competitor/brand mention rate, average position, and per-model ranking breakdown. |
81
- | `cite42_compare` | Compares one brand against competitors, including co-mention data. |
82
- | `cite42_sentiment` | Scores positive/neutral/negative brand sentiment with supporting phrases. |
83
- | `cite42_keywords` | Returns search volume, CPC, competition, competition level, and optional curated keyword ideas. |
84
- | `cite42_trends` | Returns Google Trends interest, related/rising queries, and trend direction. |
85
- | `cite42_reddit_trends` | Returns Reddit audience questions, pain points, threads, phrases, mentioned products, and URLs. |
86
- | `cite42_youtube_trends` | Returns YouTube rising videos, creator angles, title patterns, channels, and opportunities. |
87
- | `cite42_find_content_opportunities` | Combines AI search, SEO keywords, trends, Reddit, YouTube, and citations. |
88
- | `cite42_analyze_topic_demand` | Combines SEO demand, trends, AI answers, and audience conversations for a topic. |
89
- | `cite42_map_ai_prompts` | Discovers buyer prompts worth tracking from AI, SEO, trend, Reddit, and YouTube data. |
90
- | `cite42_analyze_competitor_content` | Combines AI rankings, comparisons, citations, keyword demand, and topic coverage. |
91
- | `cite42_find_ai_citation_gaps` | Finds AI queries where competitors are cited but your brand/domain/URL is not. |
92
- | `cite42_generate_content_brief` | Builds brief-ready data from AI answers, citations, SEO demand, trends, Reddit, and YouTube. |
93
-
94
- ## Model Selection
95
-
96
- The AI-search tools accept an optional `models` array:
55
+ 5. Ask your agent to use Cite42, for example:
97
56
 
98
- ```json
99
- {
100
- "query": "best customer support software for B2B SaaS",
101
- "models": ["perplexity", "gemini"]
102
- }
57
+ ```text
58
+ Use Cite42 to check which AI models cite competitors for "best customer support software".
103
59
  ```
104
60
 
105
- Omit `models` to query all five surfaces: `chatgpt`, `claude`, `perplexity`, `gemini`, and
106
- `google_ai_overview`.
61
+ ## Endpoints
107
62
 
108
- ## Keyword Ideas
63
+ These MCP tools call the matching Cite42 API endpoints.
109
64
 
110
- `cite42_keywords` can return curated keyword ideas when `ideas` is true:
65
+ ### AI Search
111
66
 
112
- ```json
113
- {
114
- "seed": "customer service software",
115
- "country": "us",
116
- "ideas": true
117
- }
118
- ```
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.
119
72
 
120
- Each idea includes provider-backed metrics:
73
+ ### SEO And Trends
121
74
 
122
- ```json
123
- {
124
- "keyword": "customer support software",
125
- "volume": 1900,
126
- "cpc": 116.7,
127
- "competition": 0.15,
128
- "competitionLevel": "LOW"
129
- }
130
- ```
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.
131
79
 
132
- The curation step selects from provider candidates only; it does not invent new keyword strings.
80
+ ### Workflows
133
81
 
134
- ## Pricing
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.
135
88
 
136
- Each successful tool call consumes credits from your Cite42 balance.
89
+ ## Configuration
137
90
 
138
- | Tool group | Price |
139
- | --- | --- |
140
- | Search, citations, rankings, compare | Google AI Overview $0.01, Gemini $0.02, ChatGPT/Claude $0.04, Perplexity $0.05 per selected model |
141
- | Sentiment | Google AI Overview $0.03, Gemini $0.04, ChatGPT/Claude $0.06, Perplexity $0.07 per selected model |
142
- | Keywords | $0.15 per call |
143
- | Google Trends | $0.01 per call |
144
- | Reddit trends | $0.05 per call |
145
- | YouTube trends | $0.05 per call |
91
+ 1. Required API key:
146
92
 
147
- Workflow tools are priced from the primitive tools they run. Check the Cite42 dashboard for current
148
- usage and balance.
93
+ ```bash
94
+ CITE42_API_KEY=cite42_live_your_key_here
95
+ ```
149
96
 
150
- ## Usage Guidance
97
+ 2. Optional custom API base:
98
+
99
+ ```bash
100
+ CITE42_API_BASE=https://api.cite42.dev/v1
101
+ ```
151
102
 
152
- Use Cite42 for AI-search, citation, SEO, keyword, trend, and market-research data. It is not a
153
- general coding or writing assistant. Code-related research is fine when the goal is to compare what
154
- AI models recommend or cite.
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
155
110
 
156
- If a task may require many calls or may cost more than a few dollars, ask the user before continuing.
111
+ Tool calls use your Cite42 credits. Without an API key and available credits, calls will fail.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@cite42/mcp",
3
- "version": "0.1.3",
4
- "description": "MCP server for the Cite42 API. Requires a Cite42 API key for AI search, citations, SEO keywords, trends, and workflows.",
3
+ "version": "0.1.5",
4
+ "description": "Stdio MCP server for Cite42 AI search, citations, SEO keywords, trends, and workflows.",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "bin": {