@orchyn/mcp 1.3.4 → 1.4.0

package/dist/shared/orchyn.js

@@ -0,0 +1,235 @@
+/**
+ * Runtime-agnostic orchyn API client — the single source of truth for the
+ * Node package (`@orchyn/mcp`) and the Cloudflare Worker (mcp.orchyn.com).
+ *
+ * Only Web-standard APIs are used (fetch, crypto, atob), so both runtimes
+ * import this same module: no duplicated client logic to keep in sync. Token
+ * storage lives behind the `TokenProvider` interface — a credentials file for
+ * the Node CLI, a KV-backed session for the Worker.
+ */
+export class OrchynError extends Error {
+    status;
+    code;
+    paywall;
+    body;
+    constructor(status, message, opts = {}) {
+        super(message);
+        this.name = "OrchynError";
+        this.status = status;
+        this.code = opts.code;
+        this.paywall = opts.paywall;
+        this.body = opts.body;
+    }
+}
+/**
+ * Extracts the `exp` claim (epoch seconds) from an orchyn JWT without
+ * verifying the signature — enough to decide whether to refresh before the
+ * 15-minute access token expires.
+ */
+export function jwtExpiry(token) {
+    try {
+        const payload = token.split(".")[1];
+        if (!payload)
+            return undefined;
+        const pad = payload.length % 4 === 0 ? "" : "=".repeat(4 - (payload.length % 4));
+        const json = atob(payload.replace(/-/g, "+").replace(/_/g, "/") + pad);
+        const claims = JSON.parse(json);
+        return typeof claims.exp === "number" ? claims.exp : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export class OrchynClient {
+    baseUrl;
+    tokenProvider;
+    constructor(baseUrl, tokenProvider) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.tokenProvider = tokenProvider;
+    }
+    async request(method, path, opts = {}) {
+        const doRequest = async (accessToken) => {
+            const headers = {};
+            if (opts.body !== undefined) {
+                headers["content-type"] = "application/json";
+            }
+            if (accessToken) {
+                headers.authorization = `Bearer ${accessToken}`;
+            }
+            return fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers,
+                body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,
+            });
+        };
+        let token = opts.token;
+        if (opts.auth && !token) {
+            token = await this.tokenProvider.getAccessToken();
+        }
+        if (opts.auth && !token) {
+            throw new OrchynError(401, "No orchyn access token available.");
+        }
+        let res = await doRequest(token);
+        if (res.status === 401 && opts.auth && this.tokenProvider.onUnauthorized) {
+            const refreshed = await this.tokenProvider.onUnauthorized();
+            if (refreshed) {
+                token = await this.tokenProvider.getAccessToken();
+                res = await doRequest(token);
+            }
+        }
+        return this.normalizeResponse(res, path);
+    }
+    async normalizeResponse(res, path) {
+        const text = await res.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : undefined;
+        }
+        catch {
+            body = undefined;
+        }
+        const json = (body ?? {});
+        const errorMessage = typeof json.error === "string" ? json.error : `orchyn API error (${res.status})`;
+        if (res.status >= 200 && res.status < 300) {
+            return body;
+        }
+        if (res.status === 402) {
+            throw new OrchynError(402, errorMessage, {
+                paywall: {
+                    reason: typeof json.reason === "string" ? json.reason : undefined,
+                    used: typeof json.used === "number" ? json.used : undefined,
+                    max: typeof json.max === "number" ? json.max : undefined,
+                    cost: typeof json.cost === "number" ? json.cost : undefined,
+                },
+                body,
+            });
+        }
+        throw new OrchynError(res.status, errorMessage, {
+            code: typeof json.code === "string" ? json.code : undefined,
+            body,
+        });
+    }
+    async startVideoAnalysis(url, appId) {
+        const res = await this.request("POST", "/mcp/analyze-post", {
+            auth: true,
+            body: appId !== undefined ? { url, appId } : { url },
+        });
+        const inline = Array.isArray(res?._inlineImages)
+            ? res._inlineImages
+            : undefined;
+        const job = res;
+        return { ...job, inlineImages: inline };
+    }
+    /**
+     * Proxies a generic orchyn backend MCP tool (`get_social_media`,
+     * `discover_social_videos`, `understand_social_post`, …) through
+     * `POST /mcp` JSON-RPC. The backend enforces per-user credit billing;
+     * tool-level failures surface as OrchynError with the backend message.
+     */
+    async callTool(name, args) {
+        const rpc = await this.request("POST", "/mcp", {
+            auth: true,
+            body: {
+                jsonrpc: "2.0",
+                id: Date.now(),
+                method: "tools/call",
+                params: { name, arguments: args },
+            },
+        });
+        if (rpc && typeof rpc === "object" && rpc.error !== undefined && rpc.error !== null) {
+            const err = rpc.error;
+            throw new OrchynError(err.code === -32002 ? 402 : 400, typeof err.message === "string" ? err.message : "orchyn MCP tool call failed");
+        }
+        const result = (rpc.result ?? {});
+        if (result.isError) {
+            const text = result.content
+                ?.filter((c) => c.type === "text")
+                .map((c) => String(c.text ?? ""))
+                .join("\n");
+            throw new OrchynError(400, text || "orchyn MCP tool call failed");
+        }
+        return {
+            contentBlocks: result.content ?? [],
+            structured: result.structuredContent,
+        };
+    }
+    async getJob(jobId) {
+        return this.request("GET", `/ai/analyze-post?jobId=${encodeURIComponent(jobId)}`, {
+            auth: true,
+        });
+    }
+    async me() {
+        return this.request("GET", "/auth/me", { auth: true });
+    }
+    async exchangeCompletionCode(code, workspaceId) {
+        return OrchynClient.exchangeCode(this.baseUrl, code, workspaceId);
+    }
+    /** Starts a Google sign-in for the given redirect URL; returns the Google redirectUrl. */
+    async startGoogleSignIn(redirect) {
+        return this.request("POST", "/auth/google/start", {
+            auth: false,
+            body: { redirect },
+        });
+    }
+    async login(email, password) {
+        return OrchynClient.login(this.baseUrl, email, password);
+    }
+    async refresh(refreshToken) {
+        return OrchynClient.refreshSession(this.baseUrl, refreshToken);
+    }
+    static async login(baseUrl, email, password) {
+        const res = await fetch(`${baseUrl.replace(/\/+$/, "")}/auth/login`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ email, password }),
+        });
+        const body = await parseJsonBody(res);
+        if (res.status >= 200 && res.status < 300) {
+            return body;
+        }
+        throw new OrchynError(res.status, typeof body?.error === "string"
+            ? body.error
+            : `Login failed (${res.status})`, { body });
+    }
+    /** Exchanges an orchyn one-time completion code (MCP login flow) for a session. */
+    static async exchangeCode(baseUrl, code, workspaceId) {
+        const res = await fetch(`${baseUrl.replace(/\/+$/, "")}/auth/oauth/complete`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(workspaceId !== undefined ? { code, workspaceId } : { code }),
+        });
+        const body = await parseJsonBody(res);
+        if (res.status >= 200 && res.status < 300) {
+            return body;
+        }
+        throw new OrchynError(res.status, typeof body?.error === "string"
+            ? body.error
+            : `Code exchange failed (${res.status})`, { body });
+    }
+    /** Redeems a refresh token for a fresh orchyn session (rotating the refresh token). */
+    static async refreshSession(baseUrl, refreshToken) {
+        const res = await fetch(`${baseUrl.replace(/\/+$/, "")}/auth/refresh`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ refreshToken }),
+        });
+        const body = await parseJsonBody(res);
+        const json = (body ?? {});
+        if (res.status >= 200 && res.status < 300) {
+            if (!json || typeof json.accessToken !== "string") {
+                throw new OrchynError(500, "Refresh succeeded but returned no access token.");
+            }
+            return body;
+        }
+        throw new OrchynError(res.status, typeof json.error === "string" ? json.error : `Refresh failed (${res.status})`, { body });
+    }
+}
+async function parseJsonBody(res) {
+    const text = await res.text();
+    try {
+        return text ? JSON.parse(text) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/shared/tools-def.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+export const TOOL_DEFINITIONS = [
+    {
+        name: "analyze_post",
+        title: "Analyze Post",
+        description: "Analyze a social post (video, image, carousel/slideshow) from its link — imports the media and runs AI analysis over the actual content (video frames, carousel images, caption). Supports TikTok, Instagram, YouTube, X/Twitter, Douyin, Xiaohongshu and Bilibili. Returns the full analysis once finished.",
+        inputSchema: z.object({ url: z.string().describe("Public post URL (TikTok/Instagram/YouTube/X, Douyin, Xiaohongshu or Bilibili).") }).strict(),
+    },
+    {
+        name: "get_social_media",
+        title: "Get Social Media",
+        description: "Fetch a social post's media from a TikTok, Instagram, YouTube, X/Twitter, Douyin, Xiaohongshu or Bilibili URL: contentType (video/image/carousel/slideshow), title, caption, author, stats and direct media URLs. Returns an inline thumbnail image. Consumes 1 orchyn credit.",
+        inputSchema: z.object({ url: z.string().describe("Full public post URL.") }).strict(),
+    },
+    {
+        name: "discover_social_posts",
+        title: "Discover Social Posts",
+        description: "Discover recent posts (video, image, carousel, slideshow) for a niche on YouTube, TikTok, Instagram, Douyin, Xiaohongshu, X/Twitter or Bilibili via TikHub. 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'."), keywords: z.string().optional().describe("Optional extra keywords."), limit: z.number().int().optional().describe("Max results (default 6)."), offset: z.number().int().optional().describe("Skip first N results — for 'next' pagination."), platform: z.enum(["youtube", "tiktok", "instagram", "douyin", "xiaohongshu", "twitter", "bilibili", "any"]).optional().describe("Platform to search (default youtube).") }).strict(),
+    },
+    {
+        name: "get_user_posts",
+        title: "Get User Posts",
+        description: "List recent posts by a creator handle (e.g. @zoundsapp) via TikHub on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili. Each post includes title/caption, thumbnailUrl, externalUrl, views/likes/comments and inline thumbnails (up to 4) so they show in chat. Use this when Claude needs to pull more posts from the same account to spot a pattern, or to scan a whole profile. Consumes 2 orchyn credits.",
+        inputSchema: z.object({ username: z.string().describe("Creator handle, e.g. 'zoundsapp' or '@zoundsapp'."), platform: z.enum(["tiktok", "instagram", "youtube", "douyin", "xiaohongshu", "twitter", "bilibili"]).optional().describe("Which platform (default tiktok)."), limit: z.number().int().optional().describe("Max posts (default 6).") }).strict(),
+    },
+    {
+        name: "analyze_creator_profile",
+        title: "Analyze Creator Profile",
+        description: "Deep-dive a whole creator profile via TikHub on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili: fetch recent posts, run multimodal Gemini on up to 3, then synthesize a profile report — creator summary, niche, content themes, hook styles, strengths/weaknesses, engagement patterns, audience insights, variation ideas, collaboration fit. Consumes 15 orchyn credits.",
+        inputSchema: z.object({ username: z.string().describe("Creator handle, e.g. 'zoundsapp'."), platform: z.enum(["tiktok", "instagram", "youtube", "douyin", "xiaohongshu", "twitter", "bilibili"]).optional().describe("Which platform (default tiktok)."), limit: z.number().int().optional().describe("Posts to fetch (default 6; first 3 analyzed)."), focus: z.string().optional().describe("Extra instruction for the profile synthesis.") }).strict(),
+    },
+    {
+        name: "get_post_comments",
+        title: "Get Post Comments",
+        description: "Fetch top comments for a post URL via TikHub on TikTok, Instagram, YouTube, Douyin, X/Twitter or Bilibili (plus keyword clusters from TikTok Analytics when available) — audience sentiment/audience-signal analysis. Consumes 2 orchyn credits.",
+        inputSchema: z.object({ url: z.string().describe("Full public post URL (TikTok/Instagram/YouTube/Douyin/X/Bilibili)."), limit: z.number().int().optional().describe("Max comments (default 20).") }).strict(),
+    },
+    {
+        name: "search_creators",
+        title: "Search Creators",
+        description: "Search creators by niche/keyword via TikHub on TikTok, Instagram, Xiaohongshu, YouTube or Douyin — username, nickname, follower count, signature, verified status. Use to find influencers to vet or analyze. Consumes 2 orchyn credits.",
+        inputSchema: z.object({ keyword: z.string().describe("Niche/keyword, e.g. 'fitness' or a creator name."), platform: z.enum(["tiktok", "instagram", "xiaohongshu", "youtube", "douyin"]).optional().describe("Which platform (default tiktok)."), count: z.number().int().optional().describe("Max creators (default 8).") }).strict(),
+    },
+    {
+        name: "get_similar_creators",
+        title: "Get Similar Creators",
+        description: "Find lookalike creators for a given handle via TikHub — TikTok similar-user recommendations or Instagram similar users. Useful for scaling: 'if this creator works, here are more like them'. Consumes 2 orchyn credits.",
+        inputSchema: z.object({ username: z.string().describe("Seed creator handle, e.g. 'zoundsapp'."), platform: z.enum(["tiktok", "instagram"]).optional().describe("Which platform (default tiktok).") }).strict(),
+    },
+    {
+        name: "discover_sounds",
+        title: "Discover Sounds",
+        description: "Discover trending sounds/music for a keyword on TikTok or Instagram via TikHub — the sound is a huge ranking signal for TikTok virality. Returns title, artist, duration, play/cover URLs. Consumes 2 orchyn credits.",
+        inputSchema: z.object({ keyword: z.string().describe("Niche/keyword, e.g. 'gym'."), platform: z.enum(["tiktok", "instagram"]).optional().describe("Which platform (default tiktok)."), count: z.number().int().optional().describe("Max sounds (default 6).") }).strict(),
+    },
+    {
+        name: "understand_social_post",
+        title: "Understand Social Post",
+        description: "Import a social post URL AND understand it with multimodal AI over the actual video/images: summary, hook strength, viral triggers, format breakdown and variation ideas. Includes the thumbnail. Supports TikTok, Instagram, YouTube, X/Twitter, Douyin, Xiaohongshu and Bilibili. Consumes 10 orchyn credits.",
+        inputSchema: z.object({ url: z.string().describe("Full public post URL (TikTok/Instagram/YouTube/X/Douyin/Xiaohongshu/Bilibili)."), focus: z.string().optional().describe("Extra instruction, e.g. 'focus on the CTA'.") }).strict(),
+    },
+    {
+        name: "check_orchyn_credits",
+        title: "Check Orchyn Credits",
+        description: "Check your MCP credit balance, billing URL and pack size. No cost — call anytime to see remaining credits before running other tools.",
+        inputSchema: z.object({}).strict(),
+    },
+    {
+        name: "buy_orchyn_credits",
+        title: "Buy Orchyn Credits",
+        description: "Buy an MCP credit pack via Stripe Checkout. Returns a secure checkout URL — open it in your browser to pay. Credits are added automatically after payment. No cost to call.",
+        inputSchema: z.object({}).strict(),
+    },
+];

package/dist/shared/tools.js

@@ -0,0 +1,300 @@
+/**
+ * The orchyn MCP tool surface, registered once and shared by the Node
+ * package (stdio/HTTP) and the Cloudflare Worker. Both runtimes supply a
+ * `makeClient` factory that resolves the caller's orchyn identity (credential
+ * file for the CLI, KV session for the worker) — the tool bodies, schemas and
+ * result formatting live here and nowhere else.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { OrchynError } from "./orchyn.js";
+import { formatPaywallError, runVideoAnalysis, validatePostUrl } from "./video.js";
+function toToolResult(proxy) {
+    const images = proxy.contentBlocks
+        .filter((c) => c.type === "image")
+        .map((c) => ({
+        type: "image",
+        data: String(c.data ?? ""),
+        mimeType: String(c.mimeType ?? "image/jpeg"),
+    }));
+    const text = JSON.stringify(proxy.structured ?? {}, null, 2);
+    return { content: [...images, { type: "text", text }] };
+}
+function toolError(prefix, err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: "text", text: `${prefix}: ${msg}` }], isError: true };
+}
+export function createMcpServer(makeClient) {
+    const server = new McpServer({
+        name: "orchyn-mcp",
+        version: "1.3.4",
+    });
+    server.registerTool("analyze_post", {
+        title: "Analyze Post",
+        description: "Analyze a social post (video, image, carousel/slideshow) from its link — " +
+            "imports the media and runs AI analysis over the actual content (video frames, carousel images, caption). " +
+            "Supports TikTok, Instagram, YouTube, X/Twitter, Douyin, Xiaohongshu and Bilibili. Returns the full analysis once finished.",
+        inputSchema: z
+            .object({
+            url: z.string().describe("Public post URL (TikTok/Instagram/YouTube/X, Douyin, Xiaohongshu or Bilibili)."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        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);
+            const images = (result.inlineImages ?? []).map((img) => ({
+                type: "image",
+                data: String(img.data),
+                mimeType: String(img.mimeType ?? "image/jpeg"),
+            }));
+            // Remove internal thumbnail field from the JSON shown to the model
+            const { inlineImages: _omit, ...rest } = result;
+            return {
+                content: [...images, { type: "text", text: JSON.stringify(rest, 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, X/Twitter, Douyin, Xiaohongshu or Bilibili URL: " +
+            "contentType (video/image/carousel/slideshow), title, caption, author, stats and direct media URLs. " +
+            "Returns an inline thumbnail image. Consumes 1 orchyn credit.",
+        inputSchema: z
+            .object({
+            url: z.string().describe("Full public post URL."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("get_social_media", { url: args.url }));
+        }
+        catch (err) {
+            return toolError("get_social_media failed", err);
+        }
+    });
+    server.registerTool("discover_social_posts", {
+        title: "Discover Social Posts",
+        description: "Discover recent posts (video, image, carousel, slideshow) for a niche on YouTube, TikTok, Instagram, Douyin, Xiaohongshu, X/Twitter or Bilibili via TikHub. " +
+            "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'."),
+            keywords: z.string().optional().describe("Optional extra keywords."),
+            limit: z.number().int().optional().describe("Max results (default 6)."),
+            offset: z.number().int().optional().describe("Skip first N results — for 'next' pagination."),
+            platform: z
+                .enum(["youtube", "tiktok", "instagram", "douyin", "xiaohongshu", "twitter", "bilibili", "any"])
+                .optional()
+                .describe("Platform to search (default youtube)."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("discover_social_posts", { ...args }));
+        }
+        catch (err) {
+            return toolError("discover_social_posts failed", err);
+        }
+    });
+    server.registerTool("get_user_posts", {
+        title: "Get User Posts",
+        description: "List recent posts by a creator handle (e.g. @zoundsapp) via TikHub on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili. " +
+            "Each post includes title/caption, thumbnailUrl, externalUrl, views/likes/comments and inline thumbnails (up to 4) so they show in chat. " +
+            "Use this when Claude needs to pull more posts from the same account to spot a pattern, or to scan a whole profile. Consumes 2 orchyn credits.",
+        inputSchema: z
+            .object({
+            username: z.string().describe("Creator handle, e.g. 'zoundsapp' or '@zoundsapp'."),
+            platform: z
+                .enum(["tiktok", "instagram", "youtube", "douyin", "xiaohongshu", "twitter", "bilibili"])
+                .optional()
+                .describe("Which platform (default tiktok)."),
+            limit: z.number().int().optional().describe("Max posts (default 6)."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("get_user_posts", { ...args }));
+        }
+        catch (err) {
+            return toolError("get_user_posts failed", err);
+        }
+    });
+    server.registerTool("analyze_creator_profile", {
+        title: "Analyze Creator Profile",
+        description: "Deep-dive a whole creator profile via TikHub on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili: fetch recent posts, run multimodal Gemini on up to 3, " +
+            "then synthesize a profile report — creator summary, niche, content themes, hook styles, strengths/weaknesses, " +
+            "engagement patterns, audience insights, variation ideas, collaboration fit. Consumes 15 orchyn credits.",
+        inputSchema: z
+            .object({
+            username: z.string().describe("Creator handle, e.g. 'zoundsapp'."),
+            platform: z
+                .enum(["tiktok", "instagram", "youtube", "douyin", "xiaohongshu", "twitter", "bilibili"])
+                .optional()
+                .describe("Which platform (default tiktok)."),
+            limit: z.number().int().optional().describe("Posts to fetch (default 6; first 3 analyzed)."),
+            focus: z.string().optional().describe("Extra instruction for the profile synthesis."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("analyze_creator_profile", { ...args }));
+        }
+        catch (err) {
+            return toolError("analyze_creator_profile failed", err);
+        }
+    });
+    server.registerTool("get_post_comments", {
+        title: "Get Post Comments",
+        description: "Fetch top comments for a post URL via TikHub on TikTok, Instagram, YouTube, Douyin, X/Twitter or Bilibili, plus keyword clusters from TikTok Analytics " +
+            "when available — audience sentiment/audience-signal analysis. Consumes 2 orchyn credits.",
+        inputSchema: z
+            .object({
+            url: z.string().describe("Full public post URL (TikTok/Instagram/YouTube/Douyin/X/Bilibili)."),
+            limit: z.number().int().optional().describe("Max comments (default 20)."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("get_post_comments", { ...args }));
+        }
+        catch (err) {
+            return toolError("get_post_comments failed", err);
+        }
+    });
+    server.registerTool("search_creators", {
+        title: "Search Creators",
+        description: "Search creators by niche/keyword via TikHub on TikTok, Instagram, Xiaohongshu, YouTube or Douyin — username, nickname, follower count, " +
+            "signature, verified status. Use to find influencers to vet or analyze. Consumes 2 orchyn credits.",
+        inputSchema: z
+            .object({
+            keyword: z.string().describe("Niche/keyword, e.g. 'fitness' or a creator name."),
+            platform: z
+                .enum(["tiktok", "instagram", "xiaohongshu", "youtube", "douyin"])
+                .optional()
+                .describe("Which platform (default tiktok)."),
+            count: z.number().int().optional().describe("Max creators (default 8)."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("search_creators", { ...args }));
+        }
+        catch (err) {
+            return toolError("search_creators failed", err);
+        }
+    });
+    server.registerTool("get_similar_creators", {
+        title: "Get Similar Creators",
+        description: "Find lookalike creators for a given handle via TikHub — TikTok similar-user recommendations or Instagram " +
+            "similar users. Useful for scaling: 'if this creator works, here are more like them'. Consumes 2 orchyn credits.",
+        inputSchema: z
+            .object({
+            username: z.string().describe("Seed creator handle, e.g. 'zoundsapp'."),
+            platform: z.enum(["tiktok", "instagram"]).optional().describe("Which platform (default tiktok)."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("get_similar_creators", { ...args }));
+        }
+        catch (err) {
+            return toolError("get_similar_creators failed", err);
+        }
+    });
+    server.registerTool("discover_sounds", {
+        title: "Discover Sounds",
+        description: "Discover trending sounds/music for a keyword on TikTok or Instagram via TikHub — the sound is a huge ranking " +
+            "signal for TikTok virality. Returns title, artist, duration, play/cover URLs. Consumes 2 orchyn credits.",
+        inputSchema: z
+            .object({
+            keyword: z.string().describe("Niche/keyword, e.g. 'gym'."),
+            platform: z.enum(["tiktok", "instagram"]).optional().describe("Which platform (default tiktok)."),
+            count: z.number().int().optional().describe("Max sounds (default 6)."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("discover_sounds", { ...args }));
+        }
+        catch (err) {
+            return toolError("discover_sounds failed", err);
+        }
+    });
+    server.registerTool("check_orchyn_credits", {
+        title: "Check Orchyn Credits",
+        description: "Check your orchyn credit balance, billing URL and pack size. No cost — call anytime to see remaining credits before running other tools.",
+        inputSchema: z.object({}).strict(),
+    }, async (_args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("check_orchyn_credits", {}));
+        }
+        catch (err) {
+            return toolError("check_orchyn_credits failed", err);
+        }
+    });
+    server.registerTool("buy_orchyn_credits", {
+        title: "Buy Orchyn Credits",
+        description: "Buy an MCP credit pack via Stripe Checkout. Returns a secure checkout URL — open it in your browser to pay. Credits are added automatically after payment. No cost to call.",
+        inputSchema: z.object({}).strict(),
+    }, async (_args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("buy_orchyn_credits", {}));
+        }
+        catch (err) {
+            return toolError("buy_orchyn_credits failed", err);
+        }
+    });
+    server.registerTool("understand_social_post", {
+        title: "Understand Social Post",
+        description: "Import a social post URL AND understand it with multimodal AI over the actual video/images: " +
+            "summary, hook strength, viral triggers, format breakdown and variation ideas. Includes the thumbnail. " +
+            "Supports TikTok, Instagram, YouTube, X/Twitter, Douyin, Xiaohongshu and Bilibili. Consumes 10 orchyn credits.",
+        inputSchema: z
+            .object({
+            url: z.string().describe("Full public post URL (TikTok/Instagram/YouTube/X/Douyin/Xiaohongshu/Bilibili)."),
+            focus: z
+                .string()
+                .optional()
+                .describe("Extra instruction, e.g. 'focus on the CTA'."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient(extra);
+        try {
+            return toToolResult(await client.callTool("understand_social_post", { ...args }));
+        }
+        catch (err) {
+            return toolError("understand_social_post failed", err);
+        }
+    });
+    return server;
+}