zernio-mcp 1.3.3 → 2.0.2

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