kadenzo-mcp 1.0.0 → 1.3.0

package/README.md

@@ -20,6 +20,10 @@ just *draft* content — it can **ship** it.
 | `upload_media` | Upload a local image/video file, get a URL for `media_urls` |
 | `get_account_analytics` | Recent posts + engagement metrics for an account |
 | `get_post_analytics` | Per-channel metrics for a post you scheduled |
+| `generate_content` | Generate post copy for a platform from a topic ("generate then schedule") |
+| `get_best_times` | Personalized best posting times for an account (Professional+) |
+| `list_mentions` | Social-listening mentions (who's talking about your keywords) |
+| `post_comment` | Post a comment/reply to your post (instagram/facebook/linkedin) |
 
 ## Setup
 

package/index.js

@@ -145,6 +145,54 @@ server.tool(
   async ({ id }) => { try { return ok(await api('GET', `/posts/${id}/analytics`)) } catch (e) { return fail(e) } },
 )
 
+server.tool(
+  'generate_content',
+  'Generate post copy for a platform from a topic — great for a "generate then schedule" flow. Returns a caption/post/description you can feed into schedule_post. Platform must be one of: instagram, tiktok, snapchat, facebook, youtube.',
+  {
+    topic: z.string().describe('What the post is about (2-500 characters).'),
+    platform: z.enum(['instagram', 'tiktok', 'snapchat', 'facebook', 'youtube']),
+    goal: z.enum(['story', 'educate', 'promote']).optional().describe('Angle for the copy. Defaults to "story".'),
+  },
+  async (a) => { try { return ok(await api('POST', '/generate', { body: a })) } catch (e) { return fail(e) } },
+)
+
+server.tool(
+  'get_best_times',
+  'Personalized best posting times for one connected account, computed from its own engagement history. Requires the Professional plan or higher. Hours are UTC; shift to the poster’s timezone. Use it to pick scheduled_for.',
+  { account_id: z.string() },
+  async ({ account_id }) => { try { return ok(await api('GET', `/accounts/${account_id}/best-times`)) } catch (e) { return fail(e) } },
+)
+
+server.tool(
+  'list_mentions',
+  'Your social-listening mentions — who is talking about the keywords you track (reddit/bluesky/youtube/hackernews/…), newest first. Filter by platform, since (ISO), or unread.',
+  {
+    platform: z.string().optional(),
+    since: z.string().optional().describe('ISO datetime; only mentions published after this.'),
+    unread: z.boolean().optional(),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+  },
+  async (a) => {
+    try {
+      const query = { platform: a.platform, since: a.since, limit: a.limit, offset: a.offset }
+      if (a.unread) query.unread = 'true'
+      return ok(await api('GET', '/mentions', { query }))
+    } catch (e) { return fail(e) }
+  },
+)
+
+server.tool(
+  'post_comment',
+  'Post a comment/reply to one of your posts. account_id from list_accounts; target_id is the platform post/media/comment id to comment on. Supported: instagram, facebook, linkedin.',
+  {
+    account_id: z.string(),
+    target_id: z.string().describe('The platform post/media/comment id to comment on.'),
+    text: z.string(),
+  },
+  async (a) => { try { return ok(await api('POST', '/comments', { body: a })) } catch (e) { return fail(e) } },
+)
+
 const transport = new StdioServerTransport()
 await server.connect(transport)
-console.error('Kadenzo MCP server running (stdio). 9 tools available.')
+console.error('Kadenzo MCP server running (stdio). 13 tools available.')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kadenzo-mcp",
-  "version": "1.0.0",
+  "version": "1.3.0",
   "description": "MCP server for Kadenzo — schedule, manage, and analyze social posts across 11 networks from any AI agent (Claude, Cursor, ChatGPT).",
   "type": "module",
   "bin": {