corent-mcp 0.4.2 → 0.5.1

package/dist/server.js

@@ -1,5 +1,5 @@
 /**
- * Shared Corent MCP server definition — the 7 tools, used by both the
+ * Shared Corent MCP server definition — the 8 tools, used by both the
  * stdio entrypoint (index.ts, for local `npx` use) and the hosted HTTP
  * entrypoint (http.ts). Keeping the tools in one place means the two
  * transports can never drift apart.
@@ -17,7 +17,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { MEDIA_WIDGET_HTML } from "./widget-html.js";
 export const DEFAULT_API_URL = "https://api.corent.tech";
-export const SERVER_VERSION = "0.4.0";
+export const SERVER_VERSION = "0.5.1";
 // --- MCP Apps (SEP-1865): the media tools render an inline widget in hosts
 // that support it (claude.ai web/desktop, others). Hosts without the extension
 // ignore the _meta and fall back to plain text results, so this is additive.
@@ -179,11 +179,7 @@ export function createCorentServer(config = {}) {
             tier: z
                 .enum(["air", "lite", "premium", "pro", "max_pro"])
                 .optional()
-                .describe("Quality tier (preferred): air=cheapest/fastest, lite=everyday, premium=production, pro=advanced, max_pro=maximum fidelity (flagship models). Overrides preference."),
-            preference: z
-                .enum(["fast", "cheap", "quality", "balanced"])
-                .default("balanced")
-                .describe("What to optimize for; Corent picks the best model tier automatically"),
+                .describe("Quality tier: air=cheapest/fastest, lite=everyday, premium=production, pro=advanced, max_pro=maximum fidelity (flagship models). Omit for a sensible default."),
             style: z
                 .enum(["photorealistic", "artistic", "anime", "logo", "text_focused"])
                 .optional()
@@ -192,9 +188,9 @@ export function createCorentServer(config = {}) {
         },
         outputSchema: imageOutput,
         annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
-    }, wrap(async ({ prompt, tier, preference, style, aspect_ratio }) => corent("/v1/images/generate", {
+    }, wrap(async ({ prompt, tier, style, aspect_ratio }) => corent("/v1/images/generate", {
         method: "POST",
-        body: JSON.stringify({ prompt, tier, preference, style, aspect_ratio }),
+        body: JSON.stringify({ prompt, tier, style, aspect_ratio }),
     })));
     server.registerTool("generate_video", {
         title: "Generate video",
@@ -205,21 +201,43 @@ export function createCorentServer(config = {}) {
             tier: z
                 .enum(["air", "lite", "premium", "pro", "max_pro"])
                 .optional()
-                .describe("Quality tier (preferred): air=cheapest/fastest, lite=everyday, premium=production, pro=advanced, max_pro=maximum fidelity (flagship models). Overrides preference."),
-            preference: z.enum(["fast", "cheap", "quality", "balanced"]).default("balanced"),
+                .describe("Quality tier: air=cheapest/fastest, lite=everyday, premium=production, pro=advanced, max_pro=maximum fidelity (flagship models). Omit for a sensible default."),
             aspect_ratio: z.enum(["16:9", "9:16", "1:1"]).default("16:9"),
             duration_s: z.number().int().min(1).max(30).optional().describe("Requested duration in seconds"),
             resolution: z
                 .enum(["720p", "1080p", "4k"])
                 .optional()
-                .describe("Pixel resolution (default 720p). Tier-capped: premium/pro allow up to 1080p, max_pro up to 4k; above the tier's cap it is clamped down, never rejected. Higher resolutions cost more (1080p ~2.5x, 4k ~5.5x). GET /v1/tiers lists each tier's menu with prices."),
+                .describe("Pixel resolution (default 720p). Tier-capped: pro allows up to 1080p, max_pro up to 4k; above the tier's cap it is clamped down, never rejected. Higher resolutions cost more (1080p ~2.5x, 4k ~5.5x). GET /v1/tiers lists each tier's menu with prices."),
             image_url: z.string().url().optional().describe("If set, animates this image instead of pure text-to-video"),
         },
         outputSchema: jobOutput,
         annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
-    }, wrap(async ({ prompt, tier, preference, aspect_ratio, duration_s, resolution, image_url }) => corent("/v1/videos/generate", {
+    }, wrap(async ({ prompt, tier, aspect_ratio, duration_s, resolution, image_url }) => corent("/v1/videos/generate", {
         method: "POST",
-        body: JSON.stringify({ prompt, tier, preference, aspect_ratio, duration_s, resolution, image_url }),
+        body: JSON.stringify({ prompt, tier, aspect_ratio, duration_s, resolution, image_url }),
+    })));
+    server.registerTool("generate_speech", {
+        title: "Generate speech (voice)",
+        description: "Generate spoken audio (text to speech) from text. Synchronous: returns the finished audio URL and the exact charge. Billed per 1,000 characters of input text (a few cents for a short narration). Failed generations are never billed.",
+        inputSchema: {
+            text: z.string().min(1).max(5000).describe("The text to speak, max 5000 characters"),
+            voice_id: z
+                .string()
+                .regex(/^[A-Za-z0-9]{8,64}$/)
+                .optional()
+                .describe("Optional provider voice id; omit for the default narration voice"),
+        },
+        outputSchema: {
+            id: z.string().optional(),
+            status: z.string().optional(),
+            audio_url: z.string().optional(),
+            meta: mediaMeta.optional(),
+            error: z.string().optional(),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, wrap(async ({ text, voice_id }) => corent("/v1/audio/speech", {
+        method: "POST",
+        body: JSON.stringify({ text, voice_id }),
     })));
     server.registerTool("get_job", {
         title: "Check job status",
@@ -248,7 +266,7 @@ export function createCorentServer(config = {}) {
     // prompt. The agent never picks a model or tier. ---
     server.registerTool("plan", {
         title: "Plan (cost preview, no generation)",
-        description: "Preview how Corent would handle a plain-language request WITHOUT generating anything (costs a fraction of a cent). Corent decides whether it's an image or video, which tier, aspect ratio, and duration, and returns the plan plus an estimated cost. Use this to decide or confirm cost before spending. If the request is something Corent can't generate (audio, text, 3D, editing, real-world actions), can_fulfill is false with a reason.",
+        description: "Preview how Corent would handle a plain-language request WITHOUT generating anything (costs a fraction of a cent). Corent decides whether it's an image or video, which tier, aspect ratio, and duration, and returns the plan plus an estimated cost. Use this to decide or confirm cost before spending. The planner covers image and video; for spoken audio call generate_speech directly. If the request is something Corent can't generate (text documents, 3D, editing, real-world actions), can_fulfill is false with a reason.",
         inputSchema: {
             intent: z
                 .string()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "corent-mcp",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "MCP server for the Corent media generation API — give any AI agent the ability to generate images and videos.",
   "mcpName": "io.github.gg13121/corent-mcp",
   "license": "MIT",