corent-mcp 0.2.0

package/README.md

@@ -0,0 +1,47 @@
+# Corent MCP Server
+
+Give any AI agent the ability to generate images and videos through the [Corent](https://corent.tech) API — one key, automatic model routing, provider fallback built in.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `plan` | Describe a request in plain language; Corent returns the plan (image vs video, tier, settings) + cost estimate, without generating |
+| `create` | Describe what you want + a spend ceiling; Corent decides everything and generates it (the "zero decisions" path) |
+| `generate_image` | Text → image, synchronous, returns a permanent URL |
+| `generate_video` | Text (or image) → video, async job |
+| `get_job` | Poll a job until completed |
+| `get_balance` | Remaining account balance |
+| `get_status` | Live tier health |
+
+The **`plan`** and **`create`** tools are the agent-native path: an agent says
+what it wants ("a 10s vertical clip of a sunrise for TikTok") and Corent picks
+image-vs-video, the tier, aspect ratio, and duration — the agent never manages
+models. `create` enforces a per-call spend ceiling so an autonomous agent can't
+overspend.
+
+## Setup
+
+Get an API key at [corent.tech](https://corent.tech), then add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "corent": {
+      "command": "npx",
+      "args": ["-y", "corent-mcp"],
+      "env": { "CORENT_API_KEY": "co_live_..." }
+    }
+  }
+}
+```
+
+For Claude Code: `claude mcp add corent -e CORENT_API_KEY=co_live_... -- npx -y corent-mcp`
+
+## Development
+
+```sh
+npm install
+npm run build
+CORENT_API_KEY=... node dist/index.js
+```

package/dist/index.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * Corent MCP server — exposes the Corent media generation API
+ * (https://corent.tech) as tools any MCP-compatible agent can call.
+ *
+ * Auth: set CORENT_API_KEY in the environment.
+ * Optional: CORENT_API_URL to point at a different API host.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const API_URL = process.env.CORENT_API_URL ?? "https://corent-api.fly.dev";
+const API_KEY = process.env.CORENT_API_KEY;
+if (!API_KEY) {
+    console.error("CORENT_API_KEY environment variable is required. Get a key at https://corent.tech");
+    process.exit(1);
+}
+async function corent(path, init) {
+    const res = await fetch(`${API_URL}${path}`, {
+        ...init,
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+            ...init?.headers,
+        },
+    });
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok) {
+        throw new Error(`Corent API ${res.status}: ${JSON.stringify(body.detail ?? body)}`);
+    }
+    return body;
+}
+function textResult(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+const server = new McpServer({ name: "corent", version: "0.2.0" });
+server.tool("generate_image", "Generate an image from a text prompt. Returns a permanent public URL. Synchronous: typically completes in 2-20 seconds. Costs a few cents, billed to the Corent account.", {
+    prompt: z.string().describe("What to generate, in plain language"),
+    preference: z
+        .enum(["fast", "cheap", "quality", "balanced"])
+        .default("balanced")
+        .describe("What to optimize for; Corent picks the best model tier automatically"),
+    style: z
+        .enum(["photorealistic", "artistic", "anime", "logo", "text_focused"])
+        .optional()
+        .describe("Optional content style hint"),
+    aspect_ratio: z.enum(["1:1", "16:9", "9:16", "4:3", "3:4"]).default("1:1"),
+}, async ({ prompt, preference, style, aspect_ratio }) => {
+    const data = await corent("/v1/images/generate", {
+        method: "POST",
+        body: JSON.stringify({ prompt, preference, style, aspect_ratio }),
+    });
+    return textResult(data);
+});
+server.tool("generate_video", "Start generating a video from a text prompt (optionally animating a source image). Asynchronous: returns a job id immediately; poll get_job until status is 'completed'. Video costs more than images (tens of cents to a few dollars depending on tier).", {
+    prompt: z.string().describe("What to generate, in plain language"),
+    preference: z.enum(["fast", "cheap", "quality", "balanced"]).default("balanced"),
+    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"),
+    image_url: z.string().url().optional().describe("If set, animates this image instead of pure text-to-video"),
+}, async ({ prompt, preference, aspect_ratio, duration_s, image_url }) => {
+    const data = await corent("/v1/videos/generate", {
+        method: "POST",
+        body: JSON.stringify({ prompt, preference, aspect_ratio, duration_s, image_url }),
+    });
+    return textResult(data);
+});
+server.tool("get_job", "Check the status of a generation job (mainly videos). When completed, the response includes the permanent media URL and the cost.", { job_id: z.string().describe("The job id returned by generate_video or generate_image") }, async ({ job_id }) => textResult(await corent(`/v1/jobs/${job_id}`)));
+server.tool("get_balance", "Get the Corent account's remaining balance in cents. Useful before starting expensive video generations.", {}, async () => textResult(await corent("/v1/account/balance")));
+server.tool("get_status", "Get live operational status of Corent's generation tiers (operational/degraded). No auth cost; useful to pick a healthy tier.", {}, async () => textResult(await corent("/v1/status")));
+// --- Intent tools: Corent's differentiator. Describe what you want in plain
+// language; Corent decides image-vs-video, tier, aspect ratio, and cleans the
+// prompt. The agent never picks a model or tier. ---
+server.tool("plan", "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.", {
+    intent: z.string().describe("What you want, in natural language, e.g. 'a 10s vertical clip of a sunrise for TikTok'"),
+}, async ({ intent }) => textResult(await corent("/v1/intent", { method: "POST", body: JSON.stringify({ intent }) })));
+server.tool("create", "Describe what you want in plain language and Corent plans AND generates it — choosing image vs video, tier, aspect ratio, and duration for you (the 'zero decisions' path). You MUST pass max_cost_cents as a spend ceiling; if the estimated cost exceeds it, nothing is generated and you're told the estimate so you can raise the ceiling. Image results come back with a URL; video results come back as a job id to poll with get_job.", {
+    intent: z.string().describe("What you want, in natural language"),
+    max_cost_cents: z
+        .number()
+        .int()
+        .min(1)
+        .describe("Spend ceiling in cents for this one generation. Corent refuses if the estimate is higher."),
+}, async ({ intent, max_cost_cents }) => textResult(await corent("/v1/intent/execute", {
+    method: "POST",
+    body: JSON.stringify({ intent, confirm_estimated_cost_cents_up_to: max_cost_cents }),
+})));
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "corent-mcp",
+  "version": "0.2.0",
+  "description": "MCP server for the Corent media generation API — give any AI agent the ability to generate images and videos.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "corent-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "image-generation",
+    "video-generation",
+    "ai-agents",
+    "corent"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  }
+}