botverse-mcp 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# @botverse/mcp
+
+MCP server for [Botverse](https://botverse.cloud) — video transcoding and document conversion for AI agents.
+
+## What it does
+
+- **Video transcoding** — MP4 (H.264), WebM (VP9), ProRes 422, GIF, MP3 extraction · $0.25/job
+- **Document conversion** — Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX · $0.05/file
+
+Three tool calls. No AWS. No FFmpeg. No infrastructure.
+
+## Setup
+
+1. Sign up at [botverse.cloud](https://botverse.cloud) — $2.50 minimum, no monthly fees
+2. Get an API key or connector URL from your dashboard
+3. Add to your MCP client config
+
+## Usage
+
+### Claude Desktop / Cursor / Windsurf
+
+```json
+{
+  "mcpServers": {
+    "botverse": {
+      "command": "npx",
+      "args": ["-y", "@botverse/mcp"],
+      "env": {
+        "BOTVERSE_API_KEY": "bv_live_..."
+      }
+    }
+  }
+}
+```
+
+Or with a connector URL (recommended for claude.ai):
+
+```json
+{
+  "mcpServers": {
+    "botverse": {
+      "command": "npx",
+      "args": ["-y", "@botverse/mcp"],
+      "env": {
+        "BOTVERSE_CONNECTOR_URL": "https://botverse.cloud/mcp?token=bv_sess_..."
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `transcode_from_url` | Transcode video from a public URL |
+| `transcode_video` | Transcode an uploaded video file |
+| `convert_content` | Convert document content inline |
+| `convert_from_url` | Convert a document from a public URL |
+| `get_job_status` | Poll a job until complete |
+| `get_download_url` | Get the signed download URL |
+| `get_wallet_balance` | Check wallet balance |
+
+## Pricing
+
+- Video transcode (≤5 min): **$0.25/job**
+- Video overage: **+$0.08/min**
+- ProRes 422: **$0.50/job**
+- Document conversion: **$0.05/file**
+
+Credits never expire. [Full pricing →](https://botverse.cloud/pricing)
+
+## Links
+
+- [Documentation](https://botverse.cloud/docs)
+- [Dashboard](https://botverse.cloud/dashboard)
+- [Support](mailto:support@botverse.cloud)

package/index.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+/**
+ * @botverse/mcp — stdio bridge for the Botverse MCP server.
+ *
+ * Reads MCP JSON-RPC from stdin, forwards to botverse.cloud/mcp,
+ * writes responses to stdout. Compatible with Claude Desktop, Cursor,
+ * VS Code, Windsurf, Zed, and any MCP-compatible agent runtime.
+ *
+ * Auth (set one):
+ *   BOTVERSE_API_KEY=bv_live_...      — API key, sent as Authorization: Bearer
+ *   BOTVERSE_CONNECTOR_URL=https://...  — Full connector URL with ?token=bv_sess_...
+ */
+
+const { createInterface } = require("readline");
+const https = require("https");
+const { URL } = require("url");
+
+const CONNECTOR_URL = process.env.BOTVERSE_CONNECTOR_URL;
+const API_KEY = process.env.BOTVERSE_API_KEY;
+const BASE_URL = "https://botverse.cloud/mcp";
+
+if (!CONNECTOR_URL && !API_KEY) {
+  process.stderr.write(
+    "[botverse-mcp] Error: set BOTVERSE_API_KEY or BOTVERSE_CONNECTOR_URL.\n" +
+    "  Get credentials at https://botverse.cloud/dashboard/api-keys\n"
+  );
+  process.exit(1);
+}
+
+function getTargetUrl() {
+  return CONNECTOR_URL || BASE_URL;
+}
+
+function getHeaders(bodyLength) {
+  const headers = {
+    "Content-Type": "application/json",
+    "Content-Length": bodyLength,
+    "User-Agent": "@botverse/mcp/1.0.0",
+  };
+  if (!CONNECTOR_URL && API_KEY) {
+    headers["Authorization"] = `Bearer ${API_KEY}`;
+  }
+  return headers;
+}
+
+function post(body) {
+  return new Promise((resolve, reject) => {
+    const raw = JSON.stringify(body);
+    const target = new URL(getTargetUrl());
+    const options = {
+      hostname: target.hostname,
+      port: target.port || 443,
+      path: target.pathname + target.search,
+      method: "POST",
+      headers: getHeaders(Buffer.byteLength(raw)),
+    };
+
+    const req = https.request(options, (res) => {
+      let data = "";
+      res.on("data", (chunk) => { data += chunk; });
+      res.on("end", () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch {
+          reject(new Error(`Non-JSON response (HTTP ${res.statusCode}): ${data.slice(0, 200)}`));
+        }
+      });
+    });
+
+    req.on("error", reject);
+    req.setTimeout(60000, () => { req.destroy(new Error("Request timed out")); });
+    req.write(raw);
+    req.end();
+  });
+}
+
+const rl = createInterface({ input: process.stdin, terminal: false });
+
+rl.on("line", async (line) => {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+
+  let message;
+  try {
+    message = JSON.parse(trimmed);
+  } catch {
+    return; // ignore malformed input
+  }
+
+  try {
+    const response = await post(message);
+    process.stdout.write(JSON.stringify(response) + "\n");
+  } catch (err) {
+    const errorResponse = {
+      jsonrpc: "2.0",
+      id: message.id ?? null,
+      error: {
+        code: -32603,
+        message: err instanceof Error ? err.message : "Internal error",
+      },
+    };
+    process.stdout.write(JSON.stringify(errorResponse) + "\n");
+  }
+});
+
+rl.on("close", () => { process.exit(0); });

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "botverse-mcp",
+  "version": "1.0.0",
+  "mcpName": "io.github.mkturner74/botverse",
+  "description": "MCP server for Botverse — video transcoding and document conversion for AI agents. $0.25/transcode · $0.05/convert · No AWS required.",
+  "main": "index.js",
+  "bin": {
+    "botverse-mcp": "index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/botverse/botverse-mcp.git"
+  },
+  "homepage": "https://botverse.cloud",
+  "bugs": {
+    "url": "https://github.com/botverse/botverse-mcp/issues"
+  },
+  "keywords": [
+    "mcp", "model-context-protocol", "ai", "agents", "video", "transcoding",
+    "document", "conversion", "botverse", "claude", "llm"
+  ],
+  "author": "Entertainment Technologists Inc. <support@botverse.cloud>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {}
+}

package/server.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.mkturner74/botverse",
+  "description": "Video transcoding (MP4, WebM, ProRes 422, GIF, MP3) and document conversion (Markdown, DOCX, PDF, HTML, XLSX) for AI agents. Prepaid wallet, per-job billing. No AWS, no FFmpeg, no infrastructure to manage.",
+  "repository": {
+    "url": "https://github.com/botverse/botverse-mcp",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "botverse-mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "BOTVERSE_API_KEY",
+          "description": "Your Botverse API key (bv_live_...). Generate at https://botverse.cloud/dashboard/api-keys",
+          "isRequired": false,
+          "isSecret": true,
+          "format": "string"
+        },
+        {
+          "name": "BOTVERSE_CONNECTOR_URL",
+          "description": "Your Botverse connector URL (https://botverse.cloud/mcp?token=bv_sess_...). Alternative to API key — recommended for claude.ai and browser clients.",
+          "isRequired": false,
+          "isSecret": true,
+          "format": "string"
+        }
+      ]
+    }
+  ]
+}