@orchyn/mcp 1.2.1 → 1.3.0

package/README.md

@@ -39,9 +39,8 @@ npx @orchyn/mcp login   # one-time sign-in (Google)
 | Tool | Credits | Description |
 |------|---------|-------------|
 | `analyze_post` | first free* | **Preferred.** Analyze any post (video, image, carousel/slideshow) from a TikTok/Instagram/YouTube/X-Twitter URL — imports the media and runs AI analysis over the actual content (video frames, carousel images, caption). Returns a `jobId` to poll via `GET /ai/analyze-post`. *First analysis free per workspace via the dashboard free grant.* |
-| `analyze_video` | first free* | **Deprecated alias of `analyze_post`** — kept for backwards compatibility. Use `analyze_post` for new integrations. |
 | `get_social_media` | 1 | Fetch a post's media from a URL: `contentType` (video/image/carousel/slideshow), title, caption, author, stats, direct media URLs **+ inline thumbnail image in chat**. |
-| `discover_social_videos` | 2 | Find recent posts for a niche (YouTube via `yt-dlp` search; TikTok/Instagram via Apify). Returns up to 6 posts with stats **and inline thumbnails** — see *Images in chat* below. |
+| `discover_social_posts` | 2 | **Preferred.** Find recent posts (video/image/carousel/slideshow) for a niche (YouTube via `yt-dlp` search; TikTok/Instagram via Apify). Each post includes title/caption, views/likes/comments, author, `externalUrl` + **inline thumbnails (4 at a time)** — see *Images in chat* below. Supports `limit`/`offset` pagination (“next”). |
 | `understand_social_post` | 10 | Import a post URL **and** analyze it with multimodal AI over the actual video/images: factual `whatHappens` description, hook strength, viral triggers, format breakdown, variation ideas, suggested hook/hashtags. Includes inline thumbnails. |
 
 All tools require a connected orchyn account and are billed against your orchyn credit balance (`POST /billing/mcp-credits/checkout` tops up).
@@ -53,8 +52,8 @@ All tools require a connected orchyn account and are billed against your orchyn
 Every tool that returns posts also renders **inline thumbnails** directly in the chat:
 
 - `get_social_media` / `understand_social_post` / `analyze_post` — up to 4 frames inline (poster + carousel slides). The full `mediaItems[].preview_url` + `thumbnailUrl` stay in `structuredContent` for the model to reason over.
-- `discover_social_videos` — each discovered post shows its thumbnail inline (up to 4 of the 6 results at once). Say **"next"** or **"show more"** — Claude will re-call `discover_social_videos` with a larger `limit` or paginate. Say **"analyze the 2nd one"** — Claude calls `analyze_post` or `understand_social_post` on that URL.
-- **Batch analysis** — ask "analyze all 4" or "understand these 3 in batch" and Claude will call `analyze_post`/`understand_social_post` once per URL in parallel and summarize. For large batches, `discover_social_videos` + a follow-up `analyze_post` per URL is the recommended flow.
+- `discover_social_posts` — each discovered post shows its thumbnail inline (up to 4 of the 6 results at once) together with its title/caption + views/likes/comments. Say **"next"** or **"show more"** — Claude will re-call `discover_social_posts` with `offset` pagination. Say **"analyze the 2nd one"** — Claude calls `analyze_post` or `understand_social_post` on that URL.
+- **Batch analysis** — ask "analyze all 4" or "understand these 3 in batch" and Claude will call `analyze_post`/`understand_social_post` once per URL in parallel and summarize. For large batches, `discover_social_posts` + a follow-up `analyze_post` per URL is the recommended flow.
 
 > The backend's `analyze_post` now watches the **actual video/images** (direct MP4, YouTube `fileUri`, or 6 carousel frames via Gemini multimodal) — not just the caption. The analysis includes a `whatHappens` field describing exactly what is seen.
 

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * orchyn-mcp — MCP server exposing a single `analyze_video` tool that runs
+ * orchyn-mcp — MCP server exposing `analyze_post` (analyze any post: video/image/carousel) that runs
  * AI video analysis through the user's orchyn account.
  *
  * Modes:
@@ -77,42 +77,6 @@ export function createServer(opts) {
             return { content: [{ type: "text", text: `Analysis failed: ${msg}` }], isError: true };
         }
     });
-    server.registerTool("analyze_video", {
-        title: "Analyze Video",
-        description: "[Deprecated — use analyze_post] Alias of analyze_post — analyzes any post type.",
-        inputSchema: z
-            .object({
-            url: z.string().describe("Public post URL (TikTok/Instagram/YouTube/X or shortlinks)."),
-        })
-            .strict(),
-    }, async (args, extra) => {
-        let session;
-        if (extra.authInfo?.token && opts.resolveSession) {
-            session = opts.resolveSession(extra.authInfo.token);
-        }
-        const client = opts.makeClient(session);
-        const validation = validatePostUrl(args.url);
-        if (!validation.ok) {
-            return {
-                content: [{ type: "text", text: `Invalid url: ${validation.error}` }],
-                isError: true,
-            };
-        }
-        try {
-            const result = await runVideoAnalysis(client, validation.url);
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-        }
-        catch (err) {
-            if (err instanceof OrchynError && err.paywall) {
-                return {
-                    content: [{ type: "text", text: `Analysis blocked: ${formatPaywallError(err)}\n\nHTTP ${err.status}: ${err.message}` }],
-                    isError: true,
-                };
-            }
-            const msg = err instanceof Error ? err.message : String(err);
-            return { content: [{ type: "text", text: `Analysis failed: ${msg}` }], isError: true };
-        }
-    });
     server.registerTool("get_social_media", {
         title: "Get Social Media",
         description: "Fetch a social post's media from a TikTok, Instagram, YouTube or X/Twitter URL: " +
@@ -132,11 +96,11 @@ export function createServer(opts) {
             return toolError("get_social_media failed", err);
         }
     });
-    server.registerTool("discover_social_videos", {
-        title: "Discover Social Videos",
-        description: "Discover recent videos/posts for a niche. YouTube via search; TikTok & Instagram via Apify. " +
-            "Returns inline thumbnails (up to 4) so they show in chat. Say \"next\" to paginate (offset), " +
-            "or \"analyze the 2nd one\" / \"analyze all\" for batch analysis. Consumes 2 orchyn credits.",
+    server.registerTool("discover_social_posts", {
+        title: "Discover Social Posts",
+        description: "Discover recent posts (video, image, carousel, slideshow) for a niche. YouTube via search; TikTok & Instagram via Apify. " +
+            "Each post includes title/caption, thumbnailUrl, externalUrl, views/likes/comments and inline thumbnails (up to 4) so they show in chat. " +
+            "Say \"next\" to paginate (offset), or \"analyze the 2nd one\" / \"analyze all\" for batch analysis. Consumes 2 orchyn credits.",
         inputSchema: z
             .object({
             niche: z.string().describe("Niche/topic, e.g. 'fitness'."),
@@ -152,10 +116,10 @@ export function createServer(opts) {
     }, async (args, extra) => {
         const client = makeClientFor(extra, opts);
         try {
-            return toToolResult(await client.callTool("discover_social_videos", { ...args }));
+            return toToolResult(await client.callTool("discover_social_posts", { ...args }));
         }
         catch (err) {
-            return toolError("discover_social_videos failed", err);
+            return toolError("discover_social_posts failed", err);
         }
     });
     server.registerTool("understand_social_post", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchyn/mcp",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "MCP server for orchyn - fetch, discover and understand TikTok/Instagram/YouTube/X posts with AI (media metadata, niche discovery, hook & viral analysis)",
   "type": "module",
   "main": "dist/index.js",