@kolbo/mcp 1.93.7 → 1.94.0

package/README.md

@@ -324,7 +324,7 @@ Requires DaVinci Resolve Studio with the Kolbo plugin open (Workspace → Workfl
 | `create_moodboard` / `update_moodboard` / `delete_moodboard` | Build/edit moodboards from image URLs (AI style analysis → master prompt) |
 | `clone_voice` / `import_elevenlabs_voice` / `delete_voice` | Custom voices: clone from an audio sample, import by ElevenLabs ID, delete |
 | `trim_video` | Frame-accurate server-side trim of a Kolbo-hosted video (async job, tool waits) |
-| `check_credits` | Check credit balance |
+| `check_credits` | Check credit balance; widget hosts show total and plan, credit-pack, and redemption breakdown, while text hosts retain the plain-text response |
 | `get_generation_status` | Check one or many generations (`generation_ids`); `wait=true` blocks server-side until done — replaces client polling loops |
 
 ## Environment Variables

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.93.7",
+  "version": "1.94.0",
   "description": "Kolbo AI MCP Server - Generate images, videos, music, speech, and sound effects from Claude Code",
   "main": "src/index.js",
   "bin": {

package/src/apps/index.js

@@ -25,6 +25,7 @@ const { fontUploadWidgetHtml } = require('./widgets/fontUpload');
 const { listWidgetHtml } = require('./widgets/list');
 const { HOST_MAP } = require('../cdn');
 const { plansWidgetHtml } = require('./widgets/plans');
+const { creditsWidgetHtml } = require('./widgets/credits');
 const { ResourceTemplate } = require('@modelcontextprotocol/sdk/server/mcp.js');
 const { McpError, ErrorCode } = require('@modelcontextprotocol/sdk/types.js');
 
@@ -36,7 +37,8 @@ const UI = {
   upload: 'ui://kolbo/upload.html',
   fontUpload: 'ui://kolbo/font-upload.html',
   list: 'ui://kolbo/list.html',
-  plans: 'ui://kolbo/plans.html',
+  plans: 'ui://kolbo/plans.html',
+  credits: 'ui://kolbo/credits.html',
 };
 
 const WIDGET_BUILDERS = {
@@ -47,7 +49,8 @@ const WIDGET_BUILDERS = {
   [UI.upload]: uploadWidgetHtml,
   [UI.fontUpload]: fontUploadWidgetHtml,
   [UI.list]: listWidgetHtml,
-  [UI.plans]: plansWidgetHtml,
+  [UI.plans]: plansWidgetHtml,
+  [UI.credits]: creditsWidgetHtml,
 };
 
 // Widgets are pure functions of source — build once per process.
@@ -169,7 +172,8 @@ function registerApps(server) {
     [UI.upload, 'Kolbo Upload Widget'],
     [UI.fontUpload, 'Kolbo Font Upload Widget'],
     [UI.list, 'Kolbo List Widget'],
-    [UI.plans, 'Kolbo Plans Widget'],
+    [UI.plans, 'Kolbo Plans Widget'],
+    [UI.credits, 'Kolbo Credit Balance Widget'],
   ]) {
     for (const u of [versionedUri(uri), uri]) {
       registerAppResource(
@@ -770,7 +774,8 @@ const TOOL_WIDGETS = {
   list_docs: UI.list,
   list_media_folders: UI.list,
   list_visual_dna_folders: UI.list,
-  show_plans: UI.plans,
+  show_plans: UI.plans,
+  check_credits: UI.credits,
   list_project_assets: UI.list,
 };
 

package/src/apps/widgets/credits.js

@@ -0,0 +1,63 @@
+'use strict';
+
+const { widgetPage } = require('../html');
+
+const BODY = `
+<style>
+#loading[hidden], #balance[hidden], #error[hidden] { display: none !important; }
+.k-credit-total { font-size: clamp(30px, 8vw, 46px); font-weight: 600; letter-spacing: -1.5px; line-height: 1.2; overflow-wrap: anywhere; }
+.k-credit-label { color: var(--text-muted); font-size: 12px; margin-top: 6px; }
+.k-credit-breakdown { margin: 22px 0 0; padding: 0; }
+.k-credit-row { display: flex; justify-content: space-between; gap: 16px; padding: 11px 0; border-top: 1px solid var(--border); font-size: 13px; }
+.k-credit-row dt { color: var(--text-muted); }
+.k-credit-row dd { margin: 0; font-variant-numeric: tabular-nums; overflow-wrap: anywhere; text-align: right; }
+</style>
+<div class="k-card">
+  <div class="k-head"><span class="k-logo" id="logo"></span><span class="k-title">Credit balance</span></div>
+  <div class="k-body" aria-live="polite">
+    <div id="loading" class="k-skel" style="height:160px" aria-label="Loading credit balance"></div>
+    <div id="balance" hidden>
+      <div class="k-credit-total" id="total"></div>
+      <div class="k-credit-label">Available credits</div>
+      <dl class="k-credit-breakdown">
+        <div class="k-credit-row"><dt>Plan credits</dt><dd id="plan"></dd></div>
+        <div class="k-credit-row"><dt>Credit pack</dt><dd id="pack"></dd></div>
+        <div class="k-credit-row"><dt>Redemption</dt><dd id="redemption"></dd></div>
+      </dl>
+      <div class="k-credit-label">Balance at time of check</div>
+    </div>
+    <div id="error" class="k-error" hidden>Credit balance unavailable. Please check again.</div>
+  </div>
+</div>`;
+
+const SCRIPT = `
+el('logo').innerHTML = KOLBO_LOGO + '<span>Kolbo</span>';
+function amount(value) {
+  if (value == null || value === '' || !Number.isFinite(Number(value))) return '\u2014';
+  return Number(value).toLocaleString('en-US', { maximumFractionDigits: 8 });
+}
+function render(result) {
+  var sc = result.structuredContent || structured(result);
+  var credits = sc && sc.credits;
+  el('loading').hidden = true;
+  el('error').hidden = !!credits && !result.isError;
+  el('balance').hidden = !credits || !!result.isError;
+  if (credits && !result.isError) {
+    el('total').textContent = amount(credits.total);
+    el('plan').textContent = amount(credits.plan_credits);
+    el('pack').textContent = amount(credits.credit_pack);
+    el('redemption').textContent = amount(credits.redemption);
+  }
+  window.kolbo.notifySize();
+}
+window.kolbo.onToolResult(render);
+window.kolbo.ready(function (ctx) {
+  if (ctx && ctx.toolInfo && ctx.toolInfo.result) render(ctx.toolInfo.result);
+});
+`;
+
+function creditsWidgetHtml() {
+  return widgetPage({ title: 'Kolbo Credit Balance', body: BODY, script: SCRIPT });
+}
+
+module.exports = { creditsWidgetHtml };

package/src/tools/models.js

@@ -440,12 +440,11 @@ function registerModelTools(server, client, options = {}) {
     async () => {
       const result = await client.get('/v1/account/credits');
 
-      return {
-        content: [{
-          type: 'text',
-          text: `Credit Balance:\n- Total: ${result.credits.total}\n- Plan credits: ${result.credits.plan_credits}\n- Credit pack: ${result.credits.credit_pack}\n- Redemption: ${result.credits.redemption}`
-        }]
-      };
+      const text = `Credit Balance:\n- Total: ${result.credits.total}\n- Plan credits: ${result.credits.plan_credits}\n- Credit pack: ${result.credits.credit_pack}\n- Redemption: ${result.credits.redemption}`;
+      return ui() ? uiResult(UI.credits, text, {
+        widget: 'credits',
+        credits: result.credits,
+      }) : { content: [{ type: 'text', text }] };
     }
   );