zernio-mcp 1.3.2 → 2.0.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 +545 -166
- package/dist/index.js +7 -1
- package/dist/index.js.map +1 -1
- package/dist/tools/accounts.d.ts +199 -91
- package/dist/tools/accounts.d.ts.map +1 -1
- package/dist/tools/accounts.js +258 -0
- package/dist/tools/accounts.js.map +1 -1
- package/dist/tools/ads.d.ts +106 -96
- package/dist/tools/ads.d.ts.map +1 -1
- package/dist/tools/ads.js +100 -0
- package/dist/tools/ads.js.map +1 -1
- package/dist/tools/analytics.d.ts +8 -70
- package/dist/tools/analytics.d.ts.map +1 -1
- package/dist/tools/automations.d.ts +7 -47
- package/dist/tools/automations.d.ts.map +1 -1
- package/dist/tools/broadcasts.d.ts +5 -39
- package/dist/tools/broadcasts.d.ts.map +1 -1
- package/dist/tools/comments.d.ts +19 -37
- package/dist/tools/comments.d.ts.map +1 -1
- package/dist/tools/comments.js +14 -0
- package/dist/tools/comments.js.map +1 -1
- package/dist/tools/connect.d.ts +43 -49
- package/dist/tools/connect.d.ts.map +1 -1
- package/dist/tools/connect.js +80 -0
- package/dist/tools/connect.js.map +1 -1
- package/dist/tools/contacts.d.ts +10 -78
- package/dist/tools/contacts.d.ts.map +1 -1
- package/dist/tools/messages.d.ts +40 -60
- package/dist/tools/messages.d.ts.map +1 -1
- package/dist/tools/messages.js +23 -0
- package/dist/tools/messages.js.map +1 -1
- package/dist/tools/posts.d.ts +101 -109
- package/dist/tools/posts.d.ts.map +1 -1
- package/dist/tools/posts.js +84 -0
- package/dist/tools/posts.js.map +1 -1
- package/dist/tools/profiles.d.ts +35 -69
- package/dist/tools/profiles.d.ts.map +1 -1
- package/dist/tools/profiles.js +50 -0
- package/dist/tools/profiles.js.map +1 -1
- package/dist/tools/queue.d.ts +65 -0
- package/dist/tools/queue.d.ts.map +1 -0
- package/dist/tools/queue.js +86 -0
- package/dist/tools/queue.js.map +1 -0
- package/dist/tools/reddit.d.ts +33 -0
- package/dist/tools/reddit.d.ts.map +1 -0
- package/dist/tools/reddit.js +44 -0
- package/dist/tools/reddit.js.map +1 -0
- package/dist/tools/reviews.d.ts +7 -32
- package/dist/tools/reviews.d.ts.map +1 -1
- package/dist/tools/social.d.ts +93 -126
- package/dist/tools/social.d.ts.map +1 -1
- package/dist/tools/social.js +120 -19
- package/dist/tools/social.js.map +1 -1
- package/dist/tools/validation.d.ts +45 -0
- package/dist/tools/validation.d.ts.map +1 -0
- package/dist/tools/validation.js +60 -0
- package/dist/tools/validation.js.map +1 -0
- package/dist/tools/whatsapp-business.d.ts +223 -127
- package/dist/tools/whatsapp-business.d.ts.map +1 -1
- package/dist/tools/whatsapp-business.js +352 -0
- package/dist/tools/whatsapp-business.js.map +1 -1
- package/package.json +50 -1
package/README.md
CHANGED
|
@@ -1,166 +1,545 @@
|
|
|
1
|
-
# zernio-mcp
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
"
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
"
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
---
|
|
61
|
-
|
|
62
|
-
## Tools
|
|
63
|
-
|
|
64
|
-
### Accounts (
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
| `
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
|
72
|
-
|
|
73
|
-
| `
|
|
74
|
-
| `
|
|
75
|
-
| `
|
|
76
|
-
| `
|
|
77
|
-
| `
|
|
78
|
-
| `
|
|
79
|
-
| `
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
|
83
|
-
|
|
84
|
-
| `
|
|
85
|
-
| `
|
|
86
|
-
| `
|
|
87
|
-
| `
|
|
88
|
-
| `
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
|
92
|
-
|
|
93
|
-
| `
|
|
94
|
-
| `
|
|
95
|
-
| `
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
|
99
|
-
|
|
100
|
-
| `
|
|
101
|
-
| `
|
|
102
|
-
| `
|
|
103
|
-
| `
|
|
104
|
-
| `
|
|
105
|
-
| `
|
|
106
|
-
| `
|
|
107
|
-
| `
|
|
108
|
-
| `
|
|
109
|
-
| `
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
|
144
|
-
|
|
145
|
-
| `
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
1
|
+
# zernio-mcp
|
|
2
|
+
|
|
3
|
+
[](https://github.com/Eyalm321/zernio-mcp/actions/workflows/ci.yml)
|
|
4
|
+
[](https://www.npmjs.com/package/zernio-mcp)
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
|
|
7
|
+
A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives Claude full access to the [Zernio](https://zernio.com) social media management API — **273 tools** covering posts, analytics, inbox, ads, contacts, WhatsApp Business, and more across 14+ platforms.
|
|
8
|
+
|
|
9
|
+
## Quick Start
|
|
10
|
+
|
|
11
|
+
### Option 1: npx (recommended)
|
|
12
|
+
|
|
13
|
+
No installation needed. Add this to your `claude_desktop_config.json`:
|
|
14
|
+
|
|
15
|
+
```json
|
|
16
|
+
{
|
|
17
|
+
"mcpServers": {
|
|
18
|
+
"zernio": {
|
|
19
|
+
"command": "npx",
|
|
20
|
+
"args": ["zernio-mcp"],
|
|
21
|
+
"env": {
|
|
22
|
+
"ZERNIO_API_KEY": "your_zernio_api_key_here"
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### Option 2: Local install
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
git clone https://github.com/Eyalm321/zernio-mcp.git
|
|
33
|
+
cd zernio-mcp
|
|
34
|
+
npm install
|
|
35
|
+
npm run build
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Then configure Claude Desktop:
|
|
39
|
+
|
|
40
|
+
```json
|
|
41
|
+
{
|
|
42
|
+
"mcpServers": {
|
|
43
|
+
"zernio": {
|
|
44
|
+
"command": "node",
|
|
45
|
+
"args": ["/absolute/path/to/zernio-mcp/dist/index.js"],
|
|
46
|
+
"env": {
|
|
47
|
+
"ZERNIO_API_KEY": "your_zernio_api_key_here"
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### Getting your API key
|
|
55
|
+
|
|
56
|
+
1. Log in to [zernio.com](https://zernio.com)
|
|
57
|
+
2. Go to **Settings > API Keys**
|
|
58
|
+
3. Create a new key and copy it
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## Tools (273 total)
|
|
63
|
+
|
|
64
|
+
### Accounts (42 tools)
|
|
65
|
+
|
|
66
|
+
| Tool | Description |
|
|
67
|
+
|------|-------------|
|
|
68
|
+
| `zernio_list_accounts` | List all connected social media accounts |
|
|
69
|
+
| `zernio_get_follower_stats` | Get follower count and stats for an account |
|
|
70
|
+
| `zernio_get_account_health` | Check connection health for all accounts |
|
|
71
|
+
| `zernio_get_single_account_health` | Check connection health for a specific account |
|
|
72
|
+
| `zernio_update_account` | Update account display name or username |
|
|
73
|
+
| `zernio_disconnect_account` | Disconnect a social media account |
|
|
74
|
+
| `zernio_get_linkedin_mentions` | Get LinkedIn mentions and tags |
|
|
75
|
+
| `zernio_get_linkedin_organizations` | List LinkedIn organization pages |
|
|
76
|
+
| `zernio_switch_linkedin_organization` | Switch LinkedIn account type |
|
|
77
|
+
| `zernio_get_facebook_page` | Get Facebook Page details |
|
|
78
|
+
| `zernio_update_facebook_page` | Update Facebook Page settings |
|
|
79
|
+
| `zernio_get_pinterest_boards` | List Pinterest boards |
|
|
80
|
+
| `zernio_set_default_pinterest_board` | Set default Pinterest board |
|
|
81
|
+
| `zernio_get_youtube_playlists` | List YouTube playlists |
|
|
82
|
+
| `zernio_set_default_youtube_playlist` | Set default YouTube playlist |
|
|
83
|
+
| `zernio_get_reddit_flairs` | List subreddit flairs |
|
|
84
|
+
| `zernio_get_reddit_subreddits` | List user's subreddits |
|
|
85
|
+
| `zernio_set_default_reddit_subreddit` | Set default subreddit |
|
|
86
|
+
| `zernio_get_tiktok_creator_info` | Get TikTok creator info and limits |
|
|
87
|
+
| `zernio_get_messenger_menu` | Get Facebook Messenger persistent menu |
|
|
88
|
+
| `zernio_set_messenger_menu` | Set Messenger persistent menu |
|
|
89
|
+
| `zernio_delete_messenger_menu` | Remove Messenger persistent menu |
|
|
90
|
+
| `zernio_get_telegram_commands` | Get Telegram bot commands |
|
|
91
|
+
| `zernio_set_telegram_commands` | Set Telegram bot commands |
|
|
92
|
+
| `zernio_delete_telegram_commands` | Remove Telegram bot commands |
|
|
93
|
+
| `zernio_get_instagram_ice_breakers` | Get Instagram DM ice breaker questions |
|
|
94
|
+
| `zernio_set_instagram_ice_breakers` | Set Instagram DM ice breakers |
|
|
95
|
+
| `zernio_delete_instagram_ice_breakers` | Remove Instagram DM ice breakers |
|
|
96
|
+
| `zernio_get_gmb_locations` | List Google Business Profile locations |
|
|
97
|
+
| `zernio_get_gmb_reviews` | Get Google Business reviews |
|
|
98
|
+
| `zernio_get_gmb_location_details` | Get GMB location details (hours, address, etc.) |
|
|
99
|
+
| `zernio_update_gmb_location_details` | Update GMB location details |
|
|
100
|
+
| `zernio_get_gmb_food_menus` | Get GMB restaurant food menus |
|
|
101
|
+
| `zernio_update_gmb_food_menus` | Update GMB food menus |
|
|
102
|
+
| `zernio_get_gmb_media` | List GMB location photos/videos |
|
|
103
|
+
| `zernio_upload_gmb_media` | Upload photo to GMB location |
|
|
104
|
+
| `zernio_delete_gmb_media` | Delete GMB media |
|
|
105
|
+
| `zernio_get_gmb_attributes` | Get GMB business attributes |
|
|
106
|
+
| `zernio_update_gmb_attributes` | Update GMB business attributes |
|
|
107
|
+
| `zernio_get_gmb_place_actions` | Get GMB action links |
|
|
108
|
+
| `zernio_create_gmb_place_action` | Create GMB action link |
|
|
109
|
+
| `zernio_delete_gmb_place_action` | Delete GMB action link |
|
|
110
|
+
|
|
111
|
+
### Posts & Media (25 tools)
|
|
112
|
+
|
|
113
|
+
| Tool | Description |
|
|
114
|
+
|------|-------------|
|
|
115
|
+
| `zernio_list_posts` | List scheduled/published posts |
|
|
116
|
+
| `zernio_get_post` | Get post details and performance |
|
|
117
|
+
| `zernio_create_post` | Create a new post (draft or scheduled) |
|
|
118
|
+
| `zernio_update_post` | Update a draft or scheduled post |
|
|
119
|
+
| `zernio_delete_post` | Delete a post |
|
|
120
|
+
| `zernio_publish_post_now` | Publish a draft immediately |
|
|
121
|
+
| `zernio_duplicate_post` | Duplicate a post as a new draft |
|
|
122
|
+
| `zernio_retry_post` | Retry a failed post |
|
|
123
|
+
| `zernio_edit_published_post` | Edit an already-published post |
|
|
124
|
+
| `zernio_unpublish_post` | Remove a published post |
|
|
125
|
+
| `zernio_update_post_metadata` | Update post tags and labels |
|
|
126
|
+
| `zernio_bulk_upload_posts` | Bulk create posts from a list |
|
|
127
|
+
| `zernio_list_post_queue` | Get the scheduled post queue |
|
|
128
|
+
| `zernio_list_post_labels` | List all post labels/tags |
|
|
129
|
+
| `zernio_get_post_approval_status` | Get post approval status |
|
|
130
|
+
| `zernio_approve_post` | Approve a pending post |
|
|
131
|
+
| `zernio_reject_post` | Reject a pending post |
|
|
132
|
+
| `zernio_validate_post_content` | Validate content against platform rules |
|
|
133
|
+
| `zernio_get_post_logs` | Get activity logs for a post |
|
|
134
|
+
| `zernio_get_publishing_logs` | Get publishing logs across all posts |
|
|
135
|
+
| `zernio_upload_media` | Upload media by URL |
|
|
136
|
+
| `zernio_upload_media_direct` | Upload media file directly |
|
|
137
|
+
| `zernio_get_media_presigned_url` | Get presigned URL for large uploads |
|
|
138
|
+
| `zernio_list_media` | List uploaded media files |
|
|
139
|
+
| `zernio_delete_media` | Delete a media file |
|
|
140
|
+
|
|
141
|
+
### Analytics (16 tools)
|
|
142
|
+
|
|
143
|
+
| Tool | Description |
|
|
144
|
+
|------|-------------|
|
|
145
|
+
| `zernio_get_post_analytics` | Post metrics: impressions, reach, likes, shares, clicks |
|
|
146
|
+
| `zernio_get_follower_analytics` | Follower growth over time |
|
|
147
|
+
| `zernio_get_best_times_to_post` | Optimal posting times based on engagement |
|
|
148
|
+
| `zernio_get_daily_metrics` | Day-by-day impressions, reach, engagement |
|
|
149
|
+
| `zernio_get_content_decay` | Post performance decay over time |
|
|
150
|
+
| `zernio_get_post_timeline` | Post performance timeline (hour by hour) |
|
|
151
|
+
| `zernio_get_posting_frequency` | Posting frequency vs engagement correlation |
|
|
152
|
+
| `zernio_get_instagram_insights` | Instagram account-level insights |
|
|
153
|
+
| `zernio_get_instagram_demographics` | Instagram audience demographics |
|
|
154
|
+
| `zernio_get_youtube_analytics` | YouTube daily views and watch time |
|
|
155
|
+
| `zernio_get_youtube_demographics` | YouTube audience demographics |
|
|
156
|
+
| `zernio_get_linkedin_analytics` | LinkedIn account-level analytics |
|
|
157
|
+
| `zernio_get_linkedin_post_analytics` | LinkedIn per-post analytics |
|
|
158
|
+
| `zernio_get_linkedin_post_reactions` | LinkedIn reactions breakdown |
|
|
159
|
+
| `zernio_get_google_business_performance` | GMB views, calls, direction requests |
|
|
160
|
+
| `zernio_get_google_business_keywords` | GMB search keywords |
|
|
161
|
+
|
|
162
|
+
### Ads (19 tools)
|
|
163
|
+
|
|
164
|
+
| Tool | Description |
|
|
165
|
+
|------|-------------|
|
|
166
|
+
| `zernio_list_ad_accounts` | List connected ad accounts |
|
|
167
|
+
| `zernio_get_ads_tree` | Get full campaign/ad-set/ad hierarchy |
|
|
168
|
+
| `zernio_list_campaigns` | List ad campaigns |
|
|
169
|
+
| `zernio_create_campaign` | Create a new campaign |
|
|
170
|
+
| `zernio_update_campaign_status` | Pause or resume a campaign |
|
|
171
|
+
| `zernio_list_ads` | List ads across campaigns |
|
|
172
|
+
| `zernio_get_ad` | Get ad details |
|
|
173
|
+
| `zernio_get_ad_analytics` | Get ad performance metrics |
|
|
174
|
+
| `zernio_create_ad` | Create a standalone ad with custom creative |
|
|
175
|
+
| `zernio_update_ad` | Update ad (pause, budget, name) |
|
|
176
|
+
| `zernio_delete_ad` | Cancel an ad |
|
|
177
|
+
| `zernio_boost_post` | Boost an existing post as a paid ad |
|
|
178
|
+
| `zernio_sync_ads` | Sync ads from platform ad managers |
|
|
179
|
+
| `zernio_list_audiences` | List custom audiences |
|
|
180
|
+
| `zernio_create_audience` | Create a custom audience |
|
|
181
|
+
| `zernio_get_audience` | Get audience details |
|
|
182
|
+
| `zernio_delete_audience` | Delete a custom audience |
|
|
183
|
+
| `zernio_add_audience_users` | Add users to an audience |
|
|
184
|
+
| `zernio_get_ad_interests` | Browse targeting interests |
|
|
185
|
+
|
|
186
|
+
### Messages / DMs (10 tools)
|
|
187
|
+
|
|
188
|
+
| Tool | Description |
|
|
189
|
+
|------|-------------|
|
|
190
|
+
| `zernio_list_conversations` | List DM conversations across platforms |
|
|
191
|
+
| `zernio_get_conversation` | Get conversation details |
|
|
192
|
+
| `zernio_list_messages` | Read messages in a conversation |
|
|
193
|
+
| `zernio_send_message` | Send a DM reply |
|
|
194
|
+
| `zernio_create_conversation` | Start a new DM conversation |
|
|
195
|
+
| `zernio_edit_message` | Edit a sent message |
|
|
196
|
+
| `zernio_delete_message` | Delete a message |
|
|
197
|
+
| `zernio_send_typing_indicator` | Show typing indicator |
|
|
198
|
+
| `zernio_react_to_message` | Add/remove emoji reactions |
|
|
199
|
+
| `zernio_update_conversation_status` | Mark as read/unread/archived |
|
|
200
|
+
|
|
201
|
+
### Comments (8 tools)
|
|
202
|
+
|
|
203
|
+
| Tool | Description |
|
|
204
|
+
|------|-------------|
|
|
205
|
+
| `zernio_list_commented_posts` | List posts with comments |
|
|
206
|
+
| `zernio_get_post_comments` | Get all comments on a post |
|
|
207
|
+
| `zernio_reply_to_comment` | Reply publicly to a comment |
|
|
208
|
+
| `zernio_private_reply_to_comment` | Send a private reply to a commenter |
|
|
209
|
+
| `zernio_like_comment` | Like a comment |
|
|
210
|
+
| `zernio_hide_comment` | Hide a comment from public view |
|
|
211
|
+
| `zernio_unhide_comment` | Unhide a hidden comment |
|
|
212
|
+
| `zernio_delete_comment` | Delete a comment |
|
|
213
|
+
|
|
214
|
+
### Reviews (3 tools)
|
|
215
|
+
|
|
216
|
+
| Tool | Description |
|
|
217
|
+
|------|-------------|
|
|
218
|
+
| `zernio_list_reviews` | List reviews across platforms |
|
|
219
|
+
| `zernio_reply_to_review` | Reply to a review |
|
|
220
|
+
| `zernio_delete_review_reply` | Delete a review reply |
|
|
221
|
+
|
|
222
|
+
### Contacts & CRM (11 tools)
|
|
223
|
+
|
|
224
|
+
| Tool | Description |
|
|
225
|
+
|------|-------------|
|
|
226
|
+
| `zernio_list_contacts` | List all contacts |
|
|
227
|
+
| `zernio_get_contact` | Get contact details |
|
|
228
|
+
| `zernio_create_contact` | Create a contact |
|
|
229
|
+
| `zernio_update_contact` | Update contact details |
|
|
230
|
+
| `zernio_delete_contact` | Delete a contact |
|
|
231
|
+
| `zernio_bulk_create_contacts` | Bulk create contacts |
|
|
232
|
+
| `zernio_get_contact_channels` | Get contact's social channels |
|
|
233
|
+
| `zernio_update_contact_field` | Update a custom field value |
|
|
234
|
+
| `zernio_list_custom_fields` | List custom field definitions |
|
|
235
|
+
| `zernio_create_custom_field` | Create a custom field |
|
|
236
|
+
| `zernio_delete_custom_field` | Delete a custom field |
|
|
237
|
+
|
|
238
|
+
### Broadcasts (7 tools)
|
|
239
|
+
|
|
240
|
+
| Tool | Description |
|
|
241
|
+
|------|-------------|
|
|
242
|
+
| `zernio_list_broadcasts` | List all broadcasts |
|
|
243
|
+
| `zernio_get_broadcast` | Get broadcast details |
|
|
244
|
+
| `zernio_create_broadcast` | Create a broadcast message |
|
|
245
|
+
| `zernio_schedule_broadcast` | Schedule a broadcast |
|
|
246
|
+
| `zernio_send_broadcast` | Send a broadcast immediately |
|
|
247
|
+
| `zernio_cancel_broadcast` | Cancel a scheduled broadcast |
|
|
248
|
+
| `zernio_get_broadcast_recipients` | Get broadcast recipient list |
|
|
249
|
+
|
|
250
|
+
### Automations (6 tools)
|
|
251
|
+
|
|
252
|
+
| Tool | Description |
|
|
253
|
+
|------|-------------|
|
|
254
|
+
| `zernio_list_automations` | List comment-to-DM automations |
|
|
255
|
+
| `zernio_get_automation` | Get automation details |
|
|
256
|
+
| `zernio_create_automation` | Create a comment automation rule |
|
|
257
|
+
| `zernio_update_automation` | Update an automation |
|
|
258
|
+
| `zernio_delete_automation` | Delete an automation |
|
|
259
|
+
| `zernio_get_automation_logs` | Get automation execution logs |
|
|
260
|
+
|
|
261
|
+
### Sequences / Drip Campaigns (8 tools)
|
|
262
|
+
|
|
263
|
+
| Tool | Description |
|
|
264
|
+
|------|-------------|
|
|
265
|
+
| `zernio_list_sequences` | List message sequences |
|
|
266
|
+
| `zernio_get_sequence` | Get sequence details and steps |
|
|
267
|
+
| `zernio_create_sequence` | Create a drip campaign sequence |
|
|
268
|
+
| `zernio_update_sequence` | Update sequence name or steps |
|
|
269
|
+
| `zernio_delete_sequence` | Delete a sequence |
|
|
270
|
+
| `zernio_activate_sequence` | Activate a paused sequence |
|
|
271
|
+
| `zernio_pause_sequence` | Pause an active sequence |
|
|
272
|
+
| `zernio_list_sequence_enrollments` | List enrolled contacts |
|
|
273
|
+
|
|
274
|
+
### Contact Enrollment (2 tools)
|
|
275
|
+
|
|
276
|
+
| Tool | Description |
|
|
277
|
+
|------|-------------|
|
|
278
|
+
| `zernio_enroll_contact_in_sequence` | Enroll a contact in a sequence |
|
|
279
|
+
| `zernio_unenroll_contact_from_sequence` | Remove a contact from a sequence |
|
|
280
|
+
|
|
281
|
+
### Tags (3 tools)
|
|
282
|
+
|
|
283
|
+
| Tool | Description |
|
|
284
|
+
|------|-------------|
|
|
285
|
+
| `zernio_list_contact_tags` | List all contact tags |
|
|
286
|
+
| `zernio_add_contact_tag` | Add a tag to a contact |
|
|
287
|
+
| `zernio_remove_contact_tag` | Remove a tag from a contact |
|
|
288
|
+
|
|
289
|
+
### Twitter/X Actions (8 tools)
|
|
290
|
+
|
|
291
|
+
| Tool | Description |
|
|
292
|
+
|------|-------------|
|
|
293
|
+
| `zernio_twitter_retweet` | Retweet a tweet |
|
|
294
|
+
| `zernio_twitter_unretweet` | Undo a retweet |
|
|
295
|
+
| `zernio_twitter_like` | Like a tweet |
|
|
296
|
+
| `zernio_twitter_unlike` | Unlike a tweet |
|
|
297
|
+
| `zernio_twitter_bookmark` | Bookmark a tweet |
|
|
298
|
+
| `zernio_twitter_remove_bookmark` | Remove a bookmark |
|
|
299
|
+
| `zernio_twitter_follow` | Follow a user |
|
|
300
|
+
| `zernio_twitter_unfollow` | Unfollow a user |
|
|
301
|
+
|
|
302
|
+
### Reddit (4 tools)
|
|
303
|
+
|
|
304
|
+
| Tool | Description |
|
|
305
|
+
|------|-------------|
|
|
306
|
+
| `zernio_reddit_upvote` | Upvote a post or comment |
|
|
307
|
+
| `zernio_reddit_submit_post` | Submit a post to a subreddit |
|
|
308
|
+
| `zernio_search_reddit` | Search Reddit posts |
|
|
309
|
+
| `zernio_get_reddit_feed` | Get subreddit feed |
|
|
310
|
+
|
|
311
|
+
### Queue Scheduling (6 tools)
|
|
312
|
+
|
|
313
|
+
| Tool | Description |
|
|
314
|
+
|------|-------------|
|
|
315
|
+
| `zernio_list_queue_slots` | List scheduled time slots |
|
|
316
|
+
| `zernio_create_queue_slot` | Create a queue slot |
|
|
317
|
+
| `zernio_update_queue_slot` | Update a queue slot |
|
|
318
|
+
| `zernio_delete_queue_slot` | Delete a queue slot |
|
|
319
|
+
| `zernio_preview_queue` | Preview upcoming scheduled slots |
|
|
320
|
+
| `zernio_get_next_queue_slot` | Get next available slot |
|
|
321
|
+
|
|
322
|
+
### Validation (4 tools)
|
|
323
|
+
|
|
324
|
+
| Tool | Description |
|
|
325
|
+
|------|-------------|
|
|
326
|
+
| `zernio_validate_post_length` | Check post character count limits |
|
|
327
|
+
| `zernio_validate_post` | Validate post content against platform rules |
|
|
328
|
+
| `zernio_validate_media` | Validate media files for a platform |
|
|
329
|
+
| `zernio_validate_subreddit` | Check if a subreddit exists |
|
|
330
|
+
|
|
331
|
+
### Connect / OAuth (17 tools)
|
|
332
|
+
|
|
333
|
+
| Tool | Description |
|
|
334
|
+
|------|-------------|
|
|
335
|
+
| `zernio_get_connect_url` | Get OAuth authorization URL for any platform |
|
|
336
|
+
| `zernio_get_pending_connection_data` | Get pending OAuth connection data |
|
|
337
|
+
| `zernio_connect_bluesky` | Connect Bluesky via credentials |
|
|
338
|
+
| `zernio_connect_telegram_start` | Start Telegram bot connection |
|
|
339
|
+
| `zernio_connect_telegram_verify` | Verify Telegram connection code |
|
|
340
|
+
| `zernio_check_telegram_connection` | Check Telegram connection status |
|
|
341
|
+
| `zernio_connect_whatsapp` | Connect WhatsApp Business |
|
|
342
|
+
| `zernio_list_facebook_pages_for_connect` | List Facebook pages during OAuth |
|
|
343
|
+
| `zernio_select_facebook_page` | Select a Facebook page to connect |
|
|
344
|
+
| `zernio_list_snapchat_profiles_for_connect` | List Snapchat profiles during OAuth |
|
|
345
|
+
| `zernio_select_snapchat_profile` | Select a Snapchat profile |
|
|
346
|
+
| `zernio_list_google_business_locations_for_connect` | List GMB locations during OAuth |
|
|
347
|
+
| `zernio_select_google_business_location` | Select a GMB location |
|
|
348
|
+
| `zernio_list_linkedin_organizations_for_connect` | List LinkedIn orgs during OAuth |
|
|
349
|
+
| `zernio_select_linkedin_organization` | Select a LinkedIn organization |
|
|
350
|
+
| `zernio_list_pinterest_boards_for_connect` | List Pinterest boards during OAuth |
|
|
351
|
+
| `zernio_select_pinterest_board` | Select a Pinterest board |
|
|
352
|
+
|
|
353
|
+
### Webhooks (5 tools)
|
|
354
|
+
|
|
355
|
+
| Tool | Description |
|
|
356
|
+
|------|-------------|
|
|
357
|
+
| `zernio_list_webhooks` | List configured webhooks |
|
|
358
|
+
| `zernio_create_webhook` | Create a webhook |
|
|
359
|
+
| `zernio_delete_webhook` | Delete a webhook |
|
|
360
|
+
| `zernio_update_webhook` | Update webhook settings |
|
|
361
|
+
| `zernio_test_webhook` | Send a test webhook event |
|
|
362
|
+
| `zernio_get_webhook_logs` | Get webhook delivery logs |
|
|
363
|
+
|
|
364
|
+
### WhatsApp Business (44 tools)
|
|
365
|
+
|
|
366
|
+
| Tool | Description |
|
|
367
|
+
|------|-------------|
|
|
368
|
+
| `zernio_get_whatsapp_business_profile` | Get WhatsApp Business profile |
|
|
369
|
+
| `zernio_update_whatsapp_business_profile` | Update business profile |
|
|
370
|
+
| `zernio_get_whatsapp_display_name` | Get display name and review status |
|
|
371
|
+
| `zernio_set_whatsapp_display_name` | Request display name change |
|
|
372
|
+
| `zernio_set_whatsapp_profile_photo` | Upload profile picture |
|
|
373
|
+
| `zernio_list_whatsapp_templates` | List message templates |
|
|
374
|
+
| `zernio_create_whatsapp_template` | Create a message template |
|
|
375
|
+
| `zernio_get_whatsapp_template` | Get template by name |
|
|
376
|
+
| `zernio_update_whatsapp_template` | Update a template |
|
|
377
|
+
| `zernio_delete_whatsapp_template` | Delete a template |
|
|
378
|
+
| `zernio_list_whatsapp_phone_numbers` | List registered phone numbers |
|
|
379
|
+
| `zernio_get_whatsapp_phone_number` | Get phone number details |
|
|
380
|
+
| `zernio_purchase_whatsapp_phone_number` | Purchase a phone number |
|
|
381
|
+
| `zernio_release_whatsapp_phone_number` | Release a phone number |
|
|
382
|
+
| `zernio_request_whatsapp_verification_code` | Request verification code |
|
|
383
|
+
| `zernio_verify_whatsapp_phone_number` | Verify a phone number |
|
|
384
|
+
| `zernio_list_whatsapp_flows` | List interactive flows |
|
|
385
|
+
| `zernio_create_whatsapp_flow` | Create a flow |
|
|
386
|
+
| `zernio_get_whatsapp_flow` | Get flow details |
|
|
387
|
+
| `zernio_update_whatsapp_flow` | Update a flow |
|
|
388
|
+
| `zernio_delete_whatsapp_flow` | Delete a flow |
|
|
389
|
+
| `zernio_publish_whatsapp_flow` | Publish a flow |
|
|
390
|
+
| `zernio_deprecate_whatsapp_flow` | Deprecate a flow |
|
|
391
|
+
| `zernio_upload_whatsapp_flow_json` | Upload flow JSON definition |
|
|
392
|
+
| `zernio_get_whatsapp_flow_json` | Get flow JSON definition |
|
|
393
|
+
| `zernio_send_whatsapp_flow_message` | Send a flow to a contact |
|
|
394
|
+
| `zernio_trigger_whatsapp_flow` | Trigger a flow for a contact |
|
|
395
|
+
| `zernio_list_whatsapp_groups` | List WhatsApp groups |
|
|
396
|
+
| `zernio_create_whatsapp_group` | Create a group |
|
|
397
|
+
| `zernio_get_whatsapp_group` | Get group details |
|
|
398
|
+
| `zernio_update_whatsapp_group` | Update group settings |
|
|
399
|
+
| `zernio_delete_whatsapp_group` | Delete a group |
|
|
400
|
+
| `zernio_add_whatsapp_group_participants` | Add group members |
|
|
401
|
+
| `zernio_remove_whatsapp_group_participants` | Remove group members |
|
|
402
|
+
| `zernio_create_whatsapp_group_invite_link` | Generate invite link |
|
|
403
|
+
| `zernio_list_whatsapp_group_join_requests` | List join requests |
|
|
404
|
+
| `zernio_approve_whatsapp_group_join_requests` | Approve join requests |
|
|
405
|
+
| `zernio_reject_whatsapp_group_join_requests` | Reject join requests |
|
|
406
|
+
| `zernio_send_whatsapp_bulk` | Bulk send template messages |
|
|
407
|
+
| `zernio_list_whatsapp_contacts` | List WhatsApp contacts |
|
|
408
|
+
| `zernio_create_whatsapp_contact` | Create a contact |
|
|
409
|
+
| `zernio_get_whatsapp_contact` | Get contact details |
|
|
410
|
+
| `zernio_update_whatsapp_contact` | Update a contact |
|
|
411
|
+
| `zernio_delete_whatsapp_contact` | Delete a contact |
|
|
412
|
+
| `zernio_import_whatsapp_contacts` | Bulk import contacts |
|
|
413
|
+
| `zernio_bulk_update_whatsapp_contacts` | Bulk update contacts |
|
|
414
|
+
| `zernio_list_whatsapp_contact_groups` | List contact groups |
|
|
415
|
+
|
|
416
|
+
### Profiles & Workspace (20 tools)
|
|
417
|
+
|
|
418
|
+
| Tool | Description |
|
|
419
|
+
|------|-------------|
|
|
420
|
+
| `zernio_get_profile` | Get current user profile |
|
|
421
|
+
| `zernio_update_profile` | Update user profile |
|
|
422
|
+
| `zernio_list_profiles` | List Zernio profiles (brands/projects) |
|
|
423
|
+
| `zernio_create_zernio_profile` | Create a new profile |
|
|
424
|
+
| `zernio_get_zernio_profile` | Get profile details |
|
|
425
|
+
| `zernio_update_zernio_profile` | Update a profile |
|
|
426
|
+
| `zernio_delete_zernio_profile` | Delete a profile |
|
|
427
|
+
| `zernio_list_account_groups` | List account groups |
|
|
428
|
+
| `zernio_create_account_group` | Create an account group |
|
|
429
|
+
| `zernio_update_account_group` | Update an account group |
|
|
430
|
+
| `zernio_delete_account_group` | Delete an account group |
|
|
431
|
+
| `zernio_list_users` | List workspace team members |
|
|
432
|
+
| `zernio_get_user` | Get user details |
|
|
433
|
+
| `zernio_invite_user` | Invite a team member |
|
|
434
|
+
| `zernio_remove_user` | Remove a team member |
|
|
435
|
+
| `zernio_create_invite_token` | Create an invite token |
|
|
436
|
+
| `zernio_get_usage_stats` | Get workspace usage statistics |
|
|
437
|
+
| `zernio_list_api_keys` | List API keys |
|
|
438
|
+
| `zernio_create_api_key` | Create an API key |
|
|
439
|
+
| `zernio_delete_api_key` | Revoke an API key |
|
|
440
|
+
|
|
441
|
+
### Logs (2 tools)
|
|
442
|
+
|
|
443
|
+
| Tool | Description |
|
|
444
|
+
|------|-------------|
|
|
445
|
+
| `zernio_get_webhook_logs` | Get webhook delivery logs |
|
|
446
|
+
| `zernio_get_connection_logs` | Get connection attempt logs |
|
|
447
|
+
|
|
448
|
+
---
|
|
449
|
+
|
|
450
|
+
## Supported Platforms
|
|
451
|
+
|
|
452
|
+
| Platform | Posts | Analytics | Inbox | Reviews | Ads |
|
|
453
|
+
|----------|-------|-----------|-------|---------|-----|
|
|
454
|
+
| Twitter/X | Yes | Yes | Yes | - | - |
|
|
455
|
+
| Instagram | Yes | Yes | Yes | - | Yes |
|
|
456
|
+
| Facebook | Yes | Yes | Yes | - | Yes |
|
|
457
|
+
| LinkedIn | Yes | Yes | Yes | - | - |
|
|
458
|
+
| TikTok | Yes | - | - | - | - |
|
|
459
|
+
| YouTube | Yes | Yes | Yes | - | - |
|
|
460
|
+
| Pinterest | Yes | - | - | - | Yes |
|
|
461
|
+
| Reddit | Yes | - | - | - | - |
|
|
462
|
+
| Bluesky | Yes | - | - | - | - |
|
|
463
|
+
| Threads | Yes | - | - | - | - |
|
|
464
|
+
| Google Business | Yes | Yes | - | Yes | Yes |
|
|
465
|
+
| Telegram | - | - | Yes | - | - |
|
|
466
|
+
| Snapchat | Yes | - | - | - | - |
|
|
467
|
+
| WhatsApp | - | - | Yes | - | - |
|
|
468
|
+
|
|
469
|
+
---
|
|
470
|
+
|
|
471
|
+
## Example Prompts
|
|
472
|
+
|
|
473
|
+
Once configured, you can ask Claude things like:
|
|
474
|
+
|
|
475
|
+
- *"What comments came in today across all my social accounts?"*
|
|
476
|
+
- *"Reply to all unanswered DMs with a friendly acknowledgment"*
|
|
477
|
+
- *"Show me the engagement stats for my last 5 Instagram posts"*
|
|
478
|
+
- *"What's the best time to post on Instagram based on my audience?"*
|
|
479
|
+
- *"Summarize all new reviews and draft replies for the 1-star ones"*
|
|
480
|
+
- *"Create a post saying 'Hello World!' scheduled for tomorrow at 9am on Twitter and LinkedIn"*
|
|
481
|
+
- *"Boost my best-performing post from this week with a $50 budget"*
|
|
482
|
+
- *"Show me my follower growth over the past 30 days"*
|
|
483
|
+
- *"Send a WhatsApp template message to all my VIP contacts"*
|
|
484
|
+
- *"Set up an automation to auto-reply when someone comments 'price' on my posts"*
|
|
485
|
+
- *"What's my Google Business Profile performance this month?"*
|
|
486
|
+
- *"Create a drip campaign sequence with 3 follow-up messages"*
|
|
487
|
+
|
|
488
|
+
---
|
|
489
|
+
|
|
490
|
+
## Development
|
|
491
|
+
|
|
492
|
+
```bash
|
|
493
|
+
npm install
|
|
494
|
+
npm run build # compile TypeScript
|
|
495
|
+
npm start # run the server
|
|
496
|
+
npm test # run all tests (667 tests)
|
|
497
|
+
npm run test:watch # run tests in watch mode
|
|
498
|
+
```
|
|
499
|
+
|
|
500
|
+
### Project Structure
|
|
501
|
+
|
|
502
|
+
```
|
|
503
|
+
src/
|
|
504
|
+
index.ts # MCP server entry point
|
|
505
|
+
client.ts # API request utility
|
|
506
|
+
tools/
|
|
507
|
+
accounts.ts # 42 tools - account management, GMB, platform settings
|
|
508
|
+
ads.ts # 19 tools - campaigns, ads, audiences, targeting
|
|
509
|
+
analytics.ts # 16 tools - metrics, demographics, insights
|
|
510
|
+
automations.ts # 6 tools - comment-to-DM automations
|
|
511
|
+
broadcasts.ts # 7 tools - mass messaging
|
|
512
|
+
comments.ts # 8 tools - comment management
|
|
513
|
+
connect.ts # 17 tools - OAuth and platform connections
|
|
514
|
+
contacts.ts # 11 tools - CRM contacts and custom fields
|
|
515
|
+
messages.ts # 10 tools - DM conversations
|
|
516
|
+
posts.ts # 25 tools - post CRUD, media, approval workflows
|
|
517
|
+
profiles.ts # 20 tools - workspace, users, API keys
|
|
518
|
+
queue.ts # 6 tools - scheduling queue slots
|
|
519
|
+
reddit.ts # 2 tools - Reddit search and feed
|
|
520
|
+
reviews.ts # 3 tools - review management
|
|
521
|
+
social.ts # 33 tools - Twitter, sequences, webhooks, tags
|
|
522
|
+
validation.ts # 4 tools - content and media validation
|
|
523
|
+
whatsapp-business.ts # 44 tools - WhatsApp Business full suite
|
|
524
|
+
__tests__/ # 667 tests across 19 test files
|
|
525
|
+
```
|
|
526
|
+
|
|
527
|
+
### Built With
|
|
528
|
+
|
|
529
|
+
- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk) - MCP server framework
|
|
530
|
+
- [Zod](https://zod.dev) - Schema validation
|
|
531
|
+
- [Vitest](https://vitest.dev) - Testing framework
|
|
532
|
+
- TypeScript / Node.js
|
|
533
|
+
|
|
534
|
+
---
|
|
535
|
+
|
|
536
|
+
## CI/CD
|
|
537
|
+
|
|
538
|
+
- **CI**: Runs on every push and PR to `main` — builds and tests on Node 20 and 22
|
|
539
|
+
- **Publish**: Automatically publishes to npm when a GitHub release is created (requires `NPM_TOKEN` secret)
|
|
540
|
+
|
|
541
|
+
---
|
|
542
|
+
|
|
543
|
+
## License
|
|
544
|
+
|
|
545
|
+
MIT
|