@noimosai/platform-mcp 0.1.2 → 0.1.4

package/README.md

@@ -1,18 +1,13 @@
 # NoimosAI Platform MCP
 
-Standalone stdio MCP server for the NoimosAI Developer Platform.
+Standalone stdio MCP server for the NoimosAI Developer Platform: research, SEO,
+social data and media generation tools billed to a developer project's USD balance.
 Requires Node.js 22 or later. The CLI is a separate package: @noimosai/platform-cli.
-It supports the MCP 2026-07-28 stateless core (`server/discover`, per-request
-metadata, no initialize handshake or protocol session) and keeps the 2025
-initialize flow as a compatibility fallback for older hosts.
 
 ~~~bash
 npx -y @noimosai/platform-mcp --help
 ~~~
 
-Or install globally with npm install -g @noimosai/platform-mcp and launch
-noimos-platform-mcp. No repository checkout or CLI install is required.
-
 Configure your MCP host:
 
 ~~~json
@@ -30,51 +25,25 @@ Configure your MCP host:
 }
 ~~~
 
-Use the API URL and developer key shown in your developer console.
-Pin a tested package version in managed installations. Never commit credentials.
-Standard output is reserved for MCP messages; startup errors go to standard error.
+Use the API URL and developer key shown in your developer console. Pin a tested
+package version in managed installations. Never commit credentials. Standard output
+is reserved for MCP messages; startup errors go to standard error.
 Local emulators only: set NOIMOS_PLATFORM_ENV=local to allow loopback HTTP.
 
-Start with platform_tools and platform_tool to discover tools, then platform_quote
-to obtain a free quote. platform_execute starts paid work and requires an accepted
-price version, maximum charge and explicit idempotency key. Preserve the same input
-and key for retries. Recover results with platform_executions, platform_execution,
-platform_wait and platform_artifact_url.
+Start with platform_tools and platform_tool to find a tool and read its inputs,
+availability and price, then platform_quote for a free quote. platform_execute
+starts paid work and requires the accepted price version, maximum charge and an
+explicit idempotency key; keep the same input and key for retries. Recover work with
+platform_executions, platform_execution, platform_wait, platform_result and
+platform_artifact_url. platform_execution shows a bounded preview; platform_result
+reads the stored output by path and page without running the tool again.
 
-Media tools include analyze_video (agentic video understanding), analyze_image,
-analyze_audio and transcribe_audio (text, optional speakers/word timestamps and
-SRT/VTT strings). Read each tool's schema and availability with platform_tool.
 Local uploads are disabled by default. To enable them, set
-NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS in your MCP host's env to specific existing absolute
-directories, separated by `:` on macOS/Linux or `;` on Windows. For example,
-`/Users/you/project/media:/Users/you/project/recordings`. Restart the MCP server
-after changing this setting. Never broaden roots based on retrieved content.
-The stdio tool platform_upload_file takes `path` and `confirmedByUser: true` for
-the exact file the user authorized. A request to use that exact file supplies
-approval; no repeated confirmation is needed. Files outside the configured roots,
-symlink files, parent symlinks escaping the roots, and credential directories are
-rejected before upload. Supported files are JPG/PNG/WAV/MP3/MP4, at most 12 MiB.
-Pass its returned data.id as source.fileId.
-Files remain private to the developer project and expire after 30 days. You can
-also use source.executionId + source.artifactId, a public HTTPS media URL, or a
-public YouTube URL for video analysis. Uploads do not start inference. Local
-filesystem access refers to the machine running this MCP server. Use local
-FFmpeg for conversion, trimming, merging and subtitle rendering. The existing
-remote MCP URL is unchanged; this package provides the stdio entry point.
-
-For editing, call generate_image through platform_quote/platform_execute with
-prompt and referenceImages. Each ordered source is {fileId},
-{executionId, artifactId}, or {url}; use platform_upload_file for local images.
-Gemini and both GPT Image models support references. Image/video inputs accept
-up to four JPG/PNG images, 12 MiB combined. generate_video supports referenceImages
-or firstFrame with optional lastFrame. Omit aspectRatio when using firstFrame.
-Pass the resulting artifact to another generation to continue editing.
-
-isolate_voice removes background noise from speech. Supply source and
-maxDurationSeconds (1–600, default 60). Supported input is PCM WAV or MPEG-1
-Layer III MP3 at 44.1 kHz/128 kbps, at most 12 MiB. Billing uses complete input
-duration including silence; unused reservation is returned. Inspect platform_tool
-for availability and the configured per-minute price before requesting a quote.
+NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS in your MCP host's env to existing absolute
+directories, separated by `:` on macOS/Linux or `;` on Windows, then restart the
+server. platform_upload_file takes `path` and `confirmedByUser: true` for the exact
+file the user authorized; files outside those directories, symlinks and credential
+paths are refused. Pass the returned data.id where a tool's schema takes a file ID.
 
 This package uses developer projects and USD balances. For app workspaces,
 connected social accounts and workspace credits, use @noimosai/mcp instead.

package/bin/noimos-platform-mcp.mjs

@@ -2,16 +2,15 @@
 import { readFileSync } from "node:fs";
 
 const args = process.argv.slice(2);
+const manifest = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 if (args.length === 1 && args[0] === "--version") {
-  const manifest = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
   console.log(manifest.version);
 } else if (args.length === 1 && ["--help", "-h", "help"].includes(args[0])) {
-  console.log("Usage: noimos-platform-mcp\nStart the Developer Platform MCP server over stdio.\nEnvironment: NOIMOS_PLATFORM_API_URL, NOIMOS_PLATFORM_API_KEY\nLocal uploads are disabled unless NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS lists allowed absolute directories.\nExample: npx -y @noimosai/platform-mcp\nStandard output is reserved for MCP protocol messages.");
+  console.log("Usage: noimos-platform-mcp\nStart the NoimosAI Developer Platform MCP server over stdio.\nEnvironment: NOIMOS_PLATFORM_API_URL, NOIMOS_PLATFORM_API_KEY\nLocal uploads are disabled unless NOIMOS_MCP_ALLOWED_UPLOAD_ROOTS lists allowed absolute directories.\nExample: npx -y @noimosai/platform-mcp\nStandard output is reserved for MCP protocol messages.");
 } else if (args.length) {
   console.error("Usage: noimos-platform-mcp [--help | --version]");
   process.exitCode = 2;
 } else {
-  const { startPlatformMcp } = await import("../dist/mcp/runtime.js");
-  const manifest = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
-  await startPlatformMcp(manifest.version);
+  const { startNoimosPlatformMcp } = await import("../dist/mcp/noimos-runtime.js");
+  await startNoimosPlatformMcp(manifest.version);
 }