celavii-mcp 0.1.0
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.
- package/README.md +108 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +1209 -0
- package/dist/index.js.map +1 -0
- package/package.json +46 -0
package/README.md
ADDED
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# Celavii MCP Server
|
|
2
|
+
|
|
3
|
+
Connect your [Celavii](https://celavii.com) account to AI-powered IDEs and assistants — Windsurf, Cursor, Claude Code, Claude.ai, VS Code + Copilot, Cline, Zed, and more.
|
|
4
|
+
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
### 1. Get your API key
|
|
8
|
+
|
|
9
|
+
Go to [celavii.com/settings/api-keys](https://celavii.com/settings/api-keys) and create an API key.
|
|
10
|
+
|
|
11
|
+
### 2. Add to your IDE
|
|
12
|
+
|
|
13
|
+
#### Windsurf / Cursor / Claude Code / Cline
|
|
14
|
+
|
|
15
|
+
Add to your MCP config file (`~/.cursor/mcp.json`, `~/.windsurf/mcp_config.json`, etc.):
|
|
16
|
+
|
|
17
|
+
```json
|
|
18
|
+
{
|
|
19
|
+
"mcpServers": {
|
|
20
|
+
"celavii": {
|
|
21
|
+
"command": "npx",
|
|
22
|
+
"args": ["-y", "celavii-mcp@latest"],
|
|
23
|
+
"env": {
|
|
24
|
+
"CELAVII_API_KEY": "cvii_live_your_key_here"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
#### Claude Desktop
|
|
32
|
+
|
|
33
|
+
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
|
|
34
|
+
|
|
35
|
+
```json
|
|
36
|
+
{
|
|
37
|
+
"mcpServers": {
|
|
38
|
+
"celavii": {
|
|
39
|
+
"command": "npx",
|
|
40
|
+
"args": ["-y", "celavii-mcp@latest"],
|
|
41
|
+
"env": {
|
|
42
|
+
"CELAVII_API_KEY": "cvii_live_your_key_here"
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### 3. Start using it
|
|
50
|
+
|
|
51
|
+
Ask your AI assistant things like:
|
|
52
|
+
|
|
53
|
+
- *"Find me 20 micro-influencers in Miami interested in fitness"*
|
|
54
|
+
- *"Add these creators to my Summer Campaign list"*
|
|
55
|
+
- *"What's the audience demographics for my campaign?"*
|
|
56
|
+
- *"Enhance these 50 profiles and notify me when done"*
|
|
57
|
+
- *"Show me the network overlap between @nike and @adidas followers"*
|
|
58
|
+
|
|
59
|
+
## Available Tools (61)
|
|
60
|
+
|
|
61
|
+
| Category | Tools | Scope Required |
|
|
62
|
+
|----------|-------|----------------|
|
|
63
|
+
| **Meta** | `get_account_info`, `get_usage` | *(none)* |
|
|
64
|
+
| **Profiles** | `search_profiles`, `search_profiles_by_affinities`, `get_profiles_bulk`, `get_profile`, `get_profile_affinities`, `get_profile_posts`, `get_profile_network`, `get_profile_followers`, `get_profile_following`, `get_profile_social_links`, `get_profile_contact` | `profiles:read`, `profiles:affinities`, `profiles:posts`, `profiles:network`, `profiles:contact` |
|
|
65
|
+
| **Campaigns** | `list_campaigns`, `get_campaign_metrics`, `get_campaign_creators`, `get_campaign_content` | `campaigns:read` |
|
|
66
|
+
| **Lists** | `list_lists`, `create_list`, `get_list`, `update_list`, `delete_list`, `get_list_members`, `add_list_members`, `remove_list_members` | `lists:read`, `lists:write` |
|
|
67
|
+
| **Analytics** | `get_demographics`, `get_locations`, `get_niches`, `get_network_overlap`, `get_shared_hashtags`, `get_hashtag_creators`, `get_affinity_posts`, `analyze_cohort`, `get_cohort_stats`, `filter_cohort` | `analytics:read` |
|
|
68
|
+
| **Content** | `search_content` | `analytics:read` |
|
|
69
|
+
| **CRM** | `get_managed_profiles`, `get_crm_summary`, `get_org_stats`, `upsert_relationship`, `delete_relationship` | `manage:read`, `manage:write` |
|
|
70
|
+
| **Knowledge** | `list_knowledge_folders`, `create_knowledge_folder`, `get_folder_entries`, `create_knowledge_entry`, `get_knowledge_entry`, `update_knowledge_entry`, `delete_knowledge_entry`, `search_knowledge` | `knowledge:read`, `knowledge:write` |
|
|
71
|
+
| **Enhance** | `enhance_profiles`, `enhance_bulk`, `confirm_enhancement`, `get_enhancement_status` | `enhance:trigger` |
|
|
72
|
+
| **Scrape** | `scrape_followers`, `scrape_following`, `scrape_locations`, `scrape_hashtags`, `scrape_urls`, `get_scrape_status` | `scrape:trigger` |
|
|
73
|
+
| **Refine** | `refine_profiles`, `get_refinement_status` | `refine:trigger` |
|
|
74
|
+
|
|
75
|
+
## Environment Variables
|
|
76
|
+
|
|
77
|
+
| Variable | Required | Description |
|
|
78
|
+
|----------|----------|-------------|
|
|
79
|
+
| `CELAVII_API_KEY` | **Yes** | Your Celavii API key (`cvii_live_...`) |
|
|
80
|
+
| `CELAVII_BASE_URL` | No | Override the API base URL (default: `https://celavii.com/api/v1`) |
|
|
81
|
+
|
|
82
|
+
## Credits & Rate Limits
|
|
83
|
+
|
|
84
|
+
Each tool has a credit cost (0-2 credits). Most read operations are free. Search, analytics, and trigger operations cost 1-2 credits.
|
|
85
|
+
|
|
86
|
+
Rate limits depend on your plan tier:
|
|
87
|
+
- **Starter:** 20 requests/min
|
|
88
|
+
- **Pro:** 60 requests/min
|
|
89
|
+
- **Enterprise:** 300 requests/min
|
|
90
|
+
|
|
91
|
+
Use `get_usage` to check your current credit balance and rate limit status.
|
|
92
|
+
|
|
93
|
+
## Development
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
# Install dependencies
|
|
97
|
+
npm install
|
|
98
|
+
|
|
99
|
+
# Build
|
|
100
|
+
npm run build
|
|
101
|
+
|
|
102
|
+
# Run locally
|
|
103
|
+
CELAVII_API_KEY=cvii_live_xxx node dist/index.js
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
## License
|
|
107
|
+
|
|
108
|
+
MIT
|
package/dist/index.d.ts
ADDED