zernio-mcp 1.0.0 → 1.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.
Files changed (2) hide show
  1. package/README.md +113 -91
  2. package/package.json +38 -38
package/README.md CHANGED
@@ -1,143 +1,165 @@
1
1
  # zernio-mcp
2
2
 
3
- A Model Context Protocol (MCP) server that gives Claude Desktop full access to your Zernio social media inbox, analytics, comments, DMs, and reviews — across Facebook, Instagram, TikTok, YouTube, Google Business, and more.
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
4
 
5
- ## What You Can Do
5
+ Zernio's official MCP only covers post scheduling. This server adds everything else: 27 tools covering your entire social media management workflow.
6
6
 
7
- Ask Claude things like:
7
+ ## Quick Start
8
8
 
9
- - "Show me the latest comments on my Instagram posts"
10
- - "Reply to the comment from @user123 saying thanks for your feedback!"
11
- - "List my unread DMs on Facebook"
12
- - "What are my follower stats this month on Instagram?"
13
- - "Show me all 1-star Google reviews in the last 30 days"
14
- - "Reply to that review with an apology and our contact info"
15
- - "What's the best time to post on TikTok?"
16
- - "How many impressions did my last 5 posts get?"
9
+ ### Option 1: npx (recommended)
17
10
 
18
- ## Available Tools (27 total)
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
19
63
 
20
64
  ### Accounts (2 tools)
21
65
  | Tool | Description |
22
66
  |------|-------------|
23
- | `zernio_list_accounts` | List all connected social accounts with platform, username, and IDs |
24
- | `zernio_get_follower_stats` | Get follower count and stats for an account |
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 |
25
69
 
26
70
  ### Comments (7 tools)
27
71
  | Tool | Description |
28
72
  |------|-------------|
29
- | `zernio_list_commented_posts` | List posts with comments across all platforms |
30
- | `zernio_get_post_comments` | Get the full comment thread on a specific post |
31
- | `zernio_reply_to_comment` | Reply to a comment publicly |
32
- | `zernio_private_reply_to_comment` | Send a private DM reply to a commenter |
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) |
33
77
  | `zernio_like_comment` | Like a comment |
34
78
  | `zernio_hide_comment` | Hide a comment from public view |
35
- | `zernio_delete_comment` | Permanently delete a comment |
79
+ | `zernio_delete_comment` | Delete a comment |
36
80
 
37
81
  ### Messages / DMs (5 tools)
38
82
  | Tool | Description |
39
83
  |------|-------------|
40
- | `zernio_list_conversations` | List all DM conversations |
41
- | `zernio_get_conversation` | Get details of a specific conversation |
42
- | `zernio_list_messages` | Read the messages in a conversation thread |
43
- | `zernio_send_message` | Send a DM or reply in a conversation |
44
- | `zernio_update_conversation_status` | Mark conversations read, unread, or archived |
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 |
45
89
 
46
90
  ### Reviews (3 tools)
47
91
  | Tool | Description |
48
92
  |------|-------------|
49
- | `zernio_list_reviews` | List customer reviews (Google Business, etc.) |
50
- | `zernio_reply_to_review` | Reply to a customer review |
51
- | `zernio_delete_review_reply` | Delete your existing reply to a review |
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 |
52
96
 
53
97
  ### Analytics (10 tools)
54
98
  | Tool | Description |
55
99
  |------|-------------|
56
- | `zernio_get_post_analytics` | Impressions, reach, likes, comments, shares for posts |
57
- | `zernio_get_follower_analytics` | Follower growth over time |
58
- | `zernio_get_best_times_to_post` | Optimal posting times based on your audience |
59
- | `zernio_get_daily_metrics` | Day-by-day account metrics |
60
- | `zernio_get_content_decay` | How post performance fades over time |
61
- | `zernio_get_instagram_insights` | Instagram reach, impressions, profile visits |
62
- | `zernio_get_instagram_demographics` | Instagram audience age, gender, location |
63
- | `zernio_get_google_business_performance` | GBP views, direction requests, calls |
64
- | `zernio_get_google_business_keywords` | Keywords people use to find your GBP |
65
- | `zernio_get_youtube_analytics` | YouTube daily views, watch time, subscribers |
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)* |
66
110
 
67
111
  ---
68
112
 
69
- ## Setup
70
-
71
- ### 1. Prerequisites
72
-
73
- - [Node.js](https://nodejs.org/) v18 or later
74
- - A [Zernio](https://zernio.com) account with connected social media accounts
75
- - [Claude Desktop](https://claude.ai/download)
76
-
77
- ### 2. Get Your Zernio API Key
78
-
79
- Go to [zernio.com/dashboard/api-keys](https://zernio.com/dashboard/api-keys) and create an API key.
80
-
81
- ### 3. Install the MCP Server
82
-
83
- ```bash
84
- git clone https://github.com/YOUR_USERNAME/zernio-mcp.git
85
- cd zernio-mcp
86
- npm install
87
- npm run build
88
- ```
113
+ ## Example prompts
89
114
 
90
- ### 4. Configure Claude Desktop
115
+ Once configured, you can ask Claude things like:
91
116
 
92
- Open your Claude Desktop config file:
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?"*
93
123
 
94
- - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
95
- - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
96
-
97
- Add the Zernio MCP server:
98
-
99
- ```json
100
- {
101
- "mcpServers": {
102
- "zernio": {
103
- "command": "node",
104
- "args": ["/absolute/path/to/zernio-mcp/dist/index.js"],
105
- "env": {
106
- "ZERNIO_API_KEY": "your_api_key_here"
107
- }
108
- }
109
- }
110
- }
111
- ```
124
+ ---
112
125
 
113
- Replace `/absolute/path/to/zernio-mcp` with the actual path where you cloned the repo, and `your_api_key_here` with your Zernio API key.
126
+ ## Supported platforms
114
127
 
115
- ### 5. Restart Claude Desktop
128
+ Platforms depend on which accounts you've connected in Zernio:
116
129
 
117
- Close and reopen Claude Desktop. The Zernio tools will be available immediately.
130
+ - Facebook
131
+ - Instagram
132
+ - TikTok
133
+ - YouTube *(analytics only)*
134
+ - Google Business Profile *(analytics and reviews)*
135
+ - LinkedIn
136
+ - Twitter/X
137
+ - Threads
118
138
 
119
139
  ---
120
140
 
121
- ## Notes on Inbox Features
141
+ ## Configuration reference
122
142
 
123
- Comments, messages, and reviews endpoints require the **Inbox add-on** in your Zernio plan. Check your plan at [zernio.com/dashboard](https://zernio.com/dashboard).
124
-
125
- Analytics endpoints require the **Analytics add-on** (`hasAnalyticsAccess: true` on your accounts).
143
+ | Config key | Description |
144
+ |------------|-------------|
145
+ | `ZERNIO_API_KEY` | Your Zernio API key (required) |
126
146
 
127
147
  ---
128
148
 
129
149
  ## Development
130
150
 
131
151
  ```bash
132
- # Run in development mode (no build step)
133
- ZERNIO_API_KEY=your_key npm run dev
152
+ npm install
153
+ npm run build # compile TypeScript
154
+ npm start # run the server
155
+ ```
134
156
 
135
- # Build for production
136
- npm run build
157
+ Built with:
158
+ - [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)
159
+ - [Zod](https://zod.dev) for schema validation
160
+ - TypeScript / Node.js
137
161
 
138
- # Run built server
139
- ZERNIO_API_KEY=your_key npm start
140
- ```
162
+ ---
141
163
 
142
164
  ## License
143
165
 
package/package.json CHANGED
@@ -1,39 +1,39 @@
1
- {
2
- "name": "zernio-mcp",
3
- "version": "1.0.0",
4
- "description": "MCP server for Zernio — social media inbox, analytics, comments, messages and reviews",
5
- "main": "dist/index.js",
6
- "bin": {
7
- "zernio-mcp": "dist/index.js"
8
- },
9
- "files": [
10
- "dist/**/*",
11
- "README.md"
12
- ],
13
- "scripts": {
14
- "build": "tsc",
15
- "start": "node dist/index.js",
16
- "dev": "ts-node src/index.ts",
17
- "prepublishOnly": "npm run build"
18
- },
19
- "keywords": ["mcp", "zernio", "social-media", "claude", "model-context-protocol", "inbox", "analytics"],
20
- "author": "Eyalm321",
21
- "repository": {
22
- "type": "git",
23
- "url": "https://github.com/Eyalm321/zernio-mcp.git"
24
- },
25
- "homepage": "https://github.com/Eyalm321/zernio-mcp#readme",
26
- "bugs": {
27
- "url": "https://github.com/Eyalm321/zernio-mcp/issues"
28
- },
29
- "license": "MIT",
30
- "dependencies": {
31
- "@modelcontextprotocol/sdk": "^1.29.0",
32
- "zod": "^4.3.6"
33
- },
34
- "devDependencies": {
35
- "@types/node": "^25.5.2",
36
- "ts-node": "^10.9.2",
37
- "typescript": "^6.0.2"
38
- }
1
+ {
2
+ "name": "zernio-mcp",
3
+ "version": "1.1.0",
4
+ "description": "MCP server for Zernio — social media inbox, analytics, comments, messages and reviews",
5
+ "main": "dist/index.js",
6
+ "bin": {
7
+ "zernio-mcp": "dist/index.js"
8
+ },
9
+ "files": [
10
+ "dist/**/*",
11
+ "README.md"
12
+ ],
13
+ "scripts": {
14
+ "build": "tsc",
15
+ "start": "node dist/index.js",
16
+ "dev": "ts-node src/index.ts",
17
+ "prepublishOnly": "npm run build"
18
+ },
19
+ "keywords": ["mcp", "zernio", "social-media", "claude", "model-context-protocol", "inbox", "analytics"],
20
+ "author": "Eyalm321",
21
+ "repository": {
22
+ "type": "git",
23
+ "url": "https://github.com/Eyalm321/zernio-mcp.git"
24
+ },
25
+ "homepage": "https://github.com/Eyalm321/zernio-mcp#readme",
26
+ "bugs": {
27
+ "url": "https://github.com/Eyalm321/zernio-mcp/issues"
28
+ },
29
+ "license": "MIT",
30
+ "dependencies": {
31
+ "@modelcontextprotocol/sdk": "^1.29.0",
32
+ "zod": "^4.3.6"
33
+ },
34
+ "devDependencies": {
35
+ "@types/node": "^25.5.2",
36
+ "ts-node": "^10.9.2",
37
+ "typescript": "^6.0.2"
38
+ }
39
39
  }