mcp-server-autoshorts 1.0.0 → 2.3.0

package/README.md

@@ -0,0 +1,166 @@
+# mcp-server-autoshorts
+
+MCP server for [AutoShort.org](https://autoshort.org) — generate AI videos from Claude, Cursor, and other MCP clients.
+
+## Quick Start
+
+```bash
+npx mcp-server-autoshorts --api-key sk_live_your_key_here
+```
+
+## Setup
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "autoshort": {
+      "command": "npx",
+      "args": ["-y", "mcp-server-autoshorts", "--api-key", "sk_live_your_key_here"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "autoshort": {
+      "command": "npx",
+      "args": ["-y", "mcp-server-autoshorts", "--api-key", "sk_live_your_key_here"]
+    }
+  }
+}
+```
+
+### Environment Variable
+
+Instead of `--api-key`, set `AUTOSHORT_API_KEY`:
+
+```bash
+export AUTOSHORT_API_KEY=sk_live_your_key_here
+npx mcp-server-autoshorts
+```
+
+## Recommended flow: Director mode
+
+When the user cares about the script or the shots, agree the video with them in the chat first,
+then let AutoShort render exactly that:
+
+1. Write the script with the user — narration per scene, and what each scene should show.
+2. `autoshort_draft_video` with `scenes: [{ narration, visual?, seconds? }]` — **free**, nothing is
+   rendered or charged. Narration is stored and read **verbatim**; `visual` becomes that scene's
+   image prompt as written (plus the art style).
+3. Show the user the draft: scenes, `estimatedDurationSeconds`, `estimatedCredits`, `warnings[]`
+   (for example: the words take ~22s to read but 30s was requested — the duration is never
+   silently changed). Apply their changes with `autoshort_update_draft`.
+4. Only after the user approves: `autoshort_render_draft`. Credits are charged at this moment,
+   before any rendering work, and refunded automatically if the render fails for good. A
+   repeated call charges nothing.
+5. Poll `autoshort_get_video` every 20-30 seconds until `COMPLETED`.
+6. To change a scene of the finished video: `autoshort_revise_scene` creates a NEW draft with the
+   change (the original is untouched); render it as a new video.
+
+No script yet? `autoshort_draft_video` with a `brief` writes a draft for review (needs a positive
+credit balance; at most 20 per hour).
+
+## The whole workflow, no website
+
+An agent can run everything through MCP. A person does only three one-time steps:
+
+1. **Authorize the connector** (OAuth "Allow" in Claude/ChatGPT) or create an API key.
+2. **Platform consent once per platform**: `autoshort_get_connection_status` returns a short,
+   single-use `connectUrl` that opens YouTube/TikTok consent directly; the agent polls the same
+   tool until `connected: true` and carries on.
+3. **A payment method once**: pay one checkout link from `autoshort_get_buy_credits_url`, or
+   approve auto-recharge (`autoshort_setup_auto_recharge`: a pack and a monthly cap, then a card
+   saved on Whop) so later top-ups run through `autoshort_buy_credits` with no link.
+
+Every error carries a machine-readable `code` and a `nextAction` (the tool to call next, or the
+`connectUrl` / `checkoutUrl` for the human). Anything still running returns `pollAfterSeconds`;
+webhooks are available instead of polling. Every paid tool takes `idempotencyKey`. Each API key /
+connector has a daily credit cap (default 500) on everything it commits through MCP (and through
+`POST /api/v1/videos/generate`), which an unattended agent cannot pass
+(`autoshort_get_limits`; raising it needs the signed-in owner).
+
+## Available Tools
+
+The tool list comes from the AutoShort server itself (`https://autoshort.org/api/mcp`), so this
+package and the remote connector (claude.ai custom connector) always expose the same tools.
+
+| Tool | Description | Cost |
+|------|-------------|------|
+| `autoshort_get_capabilities` | The end-to-end workflow, the human steps, limits | free |
+| `autoshort_list_options` | Voices (premium + price), art styles, caption themes, ratios, durations per tool, motion prices | free |
+| `autoshort_estimate_cost` | Price any paid call before making it | free |
+| `autoshort_draft_video` | Create a draft from agreed `scenes[]` (or a `brief`) | free (brief: needs credits) |
+| `autoshort_get_draft` | Read a draft with estimates and warnings | free |
+| `autoshort_update_draft` | Edit / insert / remove / reorder scenes | free |
+| `autoshort_render_draft` | Render an approved draft | charged here |
+| `autoshort_revise_scene` | Change a scene of a finished video → new draft | free (render is charged) |
+| `autoshort_generate_video` | One-shot video from a topic (AutoShort writes the script) | charged at render |
+| `autoshort_generate_chat_video` | One-shot video from a creative brief | charged at render |
+| `autoshort_generate_product_ad` | Product ad from a public product URL | charged at render |
+| `autoshort_generate_image_to_video` | Animate one image (`imagePath` is read locally) | charged at submit |
+| `autoshort_ugc_upload_recording` | App screen recording by `recordingUrl` / `recordingBase64` (`recordingPath` read locally) → `recordingAssetId` | free |
+| `autoshort_ugc_create_campaign` … `autoshort_ugc_get_campaign` | Silent UGC: campaign, hooks, preview, batch render | see tool |
+| `autoshort_get_video` | Video status and details | free |
+| `autoshort_list_videos` | Your videos with pagination | free |
+| `autoshort_cancel_video` | Cancel before rendering starts; refunded through the ledger | free |
+| `autoshort_list_niches` | Niches, art styles, qualities | free |
+| `autoshort_list_social_accounts` | Connected YouTube/TikTok accounts and today's limits (no tokens) | free |
+| `autoshort_get_connection_status` | Connected? If not, a one-click `connectUrl`; poll until connected | free |
+| `autoshort_publish_video` | YouTube upload or TikTok Drafts; idempotent per video + platform; AI disclosure set | free |
+| `autoshort_list_series` / `autoshort_create_series` / `autoshort_update_series` | Autopilot series | free (each video is charged by the scheduler) |
+| `autoshort_pause_series` / `autoshort_resume_series` | Stop / restart a series | free |
+| `autoshort_create_webhook` / `autoshort_list_webhooks` / `autoshort_delete_webhook` | Signed `video.completed` / `video.failed` POSTs | free |
+| `autoshort_get_credit_balance` | Credit balance and plan | free |
+| `autoshort_get_usage_stats` | API usage statistics | free |
+| `autoshort_get_subscription` | Subscription plan status | free |
+| `autoshort_get_limits` / `autoshort_set_limits` | Daily agent spending cap, auto-recharge, platform caps | free |
+| `autoshort_get_buy_credits_url` | Checkout link for a pack or plan (no email in the URL) | free |
+| `autoshort_setup_auto_recharge` / `autoshort_buy_credits` / `autoshort_disable_auto_recharge` | Opt-in top-ups within an owner-approved monthly cap | the pack price |
+
+Every call is authenticated with your API key, and a paid call is refused with 402 before any
+work starts when the balance is short.
+
+Webhooks: register once with `autoshort_create_webhook` (public https only); each POST is signed
+with `X-Webhook-Signature` = hex HMAC-SHA256 of the raw body with the secret returned at creation.
+Or poll `autoshort_get_video`; a PENDING video that cannot render returns `blockedReason` (for
+example `INSUFFICIENT_CREDITS`) instead of a countdown.
+
+API keys are managed in the dashboard (Developers → API keys); there is no tool for listing them.
+
+New API keys include `credits:read` and `usage:read`. A key created earlier without them gets a
+403 from `autoshort_get_credit_balance` whose message links to the page where you create a key
+with that scope.
+
+## Resources
+
+| URI | Description |
+|-----|-------------|
+| `autoshort://credits/balance` | Current credit balance |
+| `autoshort://usage/rate-limit` | API rate limit status |
+
+## Prompts
+
+| Name | Description |
+|------|-------------|
+| `generate_video` | Step-by-step guide: make, approve, publish |
+
+## Get Your API Key
+
+1. Sign up at [autoshort.org](https://autoshort.org)
+2. Go to [Developers](https://autoshort.org/en/developers)
+3. Create an API key with desired scopes
+
+## License
+
+MIT

package/dist/catalog.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Values the AutoShort API accepts or charges, as this package advertises them to agents.
+ *
+ * This package is published on its own and cannot import the app, so these are copies.
+ * Each copy is pinned to its source by src/lib/__tests__/mcp-stdio-catalog-sync.test.ts in
+ * the app (VideoStatus enum, MOTION_LANGUAGE_CODES, CHAT_MESSAGE_MAX_CHARS, FEATURE_COSTS,
+ * VideoQuality). Change the source and that test names the line to change here. Hand-typed
+ * values are how the tools came to offer status GENERATING (rejected by the API), languages
+ * en/vi only (the API speaks nine) and "40-150 credits" (an API video costs 65).
+ */
+/** Prisma VideoStatus, in schema order. */
+export declare const VIDEO_STATUSES: readonly ["PENDING", "GENERATING_SCRIPT", "GENERATING_VOICE", "FETCHING_MEDIA", "RENDERING", "COMPLETED", "FAILED", "DRAFT"];
+/** MOTION_LANGUAGE_CODES: what POST /api/videos/chat honours as an explicit language. */
+export declare const CHAT_VIDEO_LANGUAGES: readonly ["en", "es", "pt", "fr", "de", "it", "id", "tr", "vi"];
+/** CHAT_MESSAGE_MAX_CHARS. */
+export declare const CHAT_MESSAGE_MAX_CHARS = 4000;
+/** Prisma VideoQuality. */
+export declare const VIDEO_QUALITIES: readonly ["HD_720", "FULL_HD_1080"];
+/** FEATURE_COSTS.video_standard and FEATURE_COSTS.voice_over_premium. */
+export declare const CREDIT_COSTS: {
+    readonly videoStandard: 40;
+    readonly elevenLabsVoice: 25;
+};
+/** Every /api/v1 video is narrated by ElevenLabs, so the render gate asks for both. */
+export declare const API_VIDEO_CREDITS: number;
+export declare const API_VIDEO_COST_TEXT: string;
+export declare const POLL_HINT: string;
+/**
+ * FEATURE_COSTS.video_image_motion.
+ *
+ * Hand-copied like every other number here, and this one is the figure an agent budgets
+ * against BEFORE it spends: image-to-video is the only tool whose endpoint charges at submit.
+ * Pinned to the app constant by src/lib/__tests__/mcp-stdio-catalog-sync.test.ts.
+ */
+export declare const IMAGE_TO_VIDEO_CREDITS = 35;
+/**
+ * No refund promise here, deliberately.
+ *
+ * This used to say the credits are "refunded if the clip is never produced". That is not an
+ * invariant the pipeline holds. The operator-timeout path in cron/process-videos does call
+ * refundIfChargedForFailedVideo, and so does the admin refuse route — but TWO cases still end
+ * FAILED with money taken: that helper's own `refund-failed` outcome, and
+ * cron/retry-stuck-videos' permanentlyStuck `updateMany`, which has no refund call (reachable
+ * for one of these rows only once the operator has delivered and the render has then stalled
+ * MAX_RETRIES times).
+ *
+ * A longer list was checked and NARROWED: admin/videos is a GET-only dashboard whose
+ * `status: "FAILED"` occurrences are `where` filters, admin/videos/[id]/operator refunds
+ * BEFORE calling failVideo, and videos/[id]/render cannot reach its unrefunded FAILED write
+ * for these rows at all — that write is gated on `claimedByRequest` while every
+ * VEO_3_1_OPERATOR row returns ~230 lines earlier. Two real cases, not five.
+ *
+ * So the usual case refunds and the edges do not, which makes "it is refunded" a promise we
+ * cannot keep. Say what is true and name the check instead, so an agent that was charged for
+ * nothing can find out.
+ */
+export declare const IMAGE_TO_VIDEO_COST_TEXT: string;
+/**
+ * What an agent actually gets if the clip is fulfilled in operator mode.
+ *
+ * Image-to-video always renders through VEO_3_1_OPERATOR, which is a human driving a browser
+ * (scripts/veo-operator/run.mjs) — not an automatic provider. If nobody fulfils it inside the
+ * wait window the video FAILS. The refund wording is hedged for the reason in
+ * IMAGE_TO_VIDEO_COST_TEXT above; it previously claimed "any charge is refunded" flatly.
+ */
+export declare const OPERATOR_MODE_WARNING: string;
+/**
+ * Image-to-video dedupes on a requestId this package derives from the image bytes and the
+ * motion prompt — not on an Idempotency-Key header. The id carries no time component on
+ * purpose; the 24h bound is a continuous window on the server's lookup, so no two
+ * near-simultaneous retries can fall on different sides of it.
+ */
+export declare const IMAGE_TO_VIDEO_IDEMPOTENCY_HINT: string;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,cAAc,8HASjB,CAAC;AAEX,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,iEAAkE,CAAC;AAEpG,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,2BAA2B;AAC3B,eAAO,MAAM,eAAe,qCAAsC,CAAC;AAEnE,yEAAyE;AACzE,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,QAA4D,CAAC;AAE3F,eAAO,MAAM,mBAAmB,QAE2D,CAAC;AAE5F,eAAO,MAAM,SAAS,QAEmE,CAAC;AAE1F;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,wBAAwB,QAI8D,CAAC;AAEpG;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,QAIe,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,QAMsB,CAAC"}

package/dist/catalog.js

@@ -0,0 +1,96 @@
+/**
+ * Values the AutoShort API accepts or charges, as this package advertises them to agents.
+ *
+ * This package is published on its own and cannot import the app, so these are copies.
+ * Each copy is pinned to its source by src/lib/__tests__/mcp-stdio-catalog-sync.test.ts in
+ * the app (VideoStatus enum, MOTION_LANGUAGE_CODES, CHAT_MESSAGE_MAX_CHARS, FEATURE_COSTS,
+ * VideoQuality). Change the source and that test names the line to change here. Hand-typed
+ * values are how the tools came to offer status GENERATING (rejected by the API), languages
+ * en/vi only (the API speaks nine) and "40-150 credits" (an API video costs 65).
+ */
+/** Prisma VideoStatus, in schema order. */
+export const VIDEO_STATUSES = [
+    'PENDING',
+    'GENERATING_SCRIPT',
+    'GENERATING_VOICE',
+    'FETCHING_MEDIA',
+    'RENDERING',
+    'COMPLETED',
+    'FAILED',
+    'DRAFT',
+];
+/** MOTION_LANGUAGE_CODES: what POST /api/videos/chat honours as an explicit language. */
+export const CHAT_VIDEO_LANGUAGES = ['en', 'es', 'pt', 'fr', 'de', 'it', 'id', 'tr', 'vi'];
+/** CHAT_MESSAGE_MAX_CHARS. */
+export const CHAT_MESSAGE_MAX_CHARS = 4000;
+/** Prisma VideoQuality. */
+export const VIDEO_QUALITIES = ['HD_720', 'FULL_HD_1080'];
+/** FEATURE_COSTS.video_standard and FEATURE_COSTS.voice_over_premium. */
+export const CREDIT_COSTS = {
+    videoStandard: 40,
+    elevenLabsVoice: 25,
+};
+/** Every /api/v1 video is narrated by ElevenLabs, so the render gate asks for both. */
+export const API_VIDEO_CREDITS = CREDIT_COSTS.videoStandard + CREDIT_COSTS.elevenLabsVoice;
+export const API_VIDEO_COST_TEXT = `Costs ${API_VIDEO_CREDITS} credits (${CREDIT_COSTS.videoStandard} render + ` +
+    `${CREDIT_COSTS.elevenLabsVoice} ElevenLabs voice); art style does not change the price.`;
+export const POLL_HINT = 'Rendering is asynchronous: poll autoshort_get_video every 20-30 seconds until status is COMPLETED or FAILED. ' +
+    'If get_video returns blockedReason, stop polling and act on it (e.g. top up credits).';
+/**
+ * FEATURE_COSTS.video_image_motion.
+ *
+ * Hand-copied like every other number here, and this one is the figure an agent budgets
+ * against BEFORE it spends: image-to-video is the only tool whose endpoint charges at submit.
+ * Pinned to the app constant by src/lib/__tests__/mcp-stdio-catalog-sync.test.ts.
+ */
+export const IMAGE_TO_VIDEO_CREDITS = 35;
+/**
+ * No refund promise here, deliberately.
+ *
+ * This used to say the credits are "refunded if the clip is never produced". That is not an
+ * invariant the pipeline holds. The operator-timeout path in cron/process-videos does call
+ * refundIfChargedForFailedVideo, and so does the admin refuse route — but TWO cases still end
+ * FAILED with money taken: that helper's own `refund-failed` outcome, and
+ * cron/retry-stuck-videos' permanentlyStuck `updateMany`, which has no refund call (reachable
+ * for one of these rows only once the operator has delivered and the render has then stalled
+ * MAX_RETRIES times).
+ *
+ * A longer list was checked and NARROWED: admin/videos is a GET-only dashboard whose
+ * `status: "FAILED"` occurrences are `where` filters, admin/videos/[id]/operator refunds
+ * BEFORE calling failVideo, and videos/[id]/render cannot reach its unrefunded FAILED write
+ * for these rows at all — that write is gated on `claimedByRequest` while every
+ * VEO_3_1_OPERATOR row returns ~230 lines earlier. Two real cases, not five.
+ *
+ * So the usual case refunds and the edges do not, which makes "it is refunded" a promise we
+ * cannot keep. Say what is true and name the check instead, so an agent that was charged for
+ * nothing can find out.
+ */
+export const IMAGE_TO_VIDEO_COST_TEXT = `Costs ${IMAGE_TO_VIDEO_CREDITS} credits, and unlike every other tool here it is charged ` +
+    'the moment the job is accepted, not when the clip is delivered. A failed clip is normally ' +
+    'refunded automatically, but that is not guaranteed on every failure path: if the video ends ' +
+    'FAILED, check autoshort_get_credit_balance and report a missing refund rather than assuming it.';
+/**
+ * What an agent actually gets if the clip is fulfilled in operator mode.
+ *
+ * Image-to-video always renders through VEO_3_1_OPERATOR, which is a human driving a browser
+ * (scripts/veo-operator/run.mjs) — not an automatic provider. If nobody fulfils it inside the
+ * wait window the video FAILS. The refund wording is hedged for the reason in
+ * IMAGE_TO_VIDEO_COST_TEXT above; it previously claimed "any charge is refunded" flatly.
+ */
+export const OPERATOR_MODE_WARNING = 'Fulfilment is MANUAL: a human operator animates the image, it is not an automatic render. ' +
+    'If nobody fulfils it within VEO_OPERATOR_WAIT_MINUTES (10 in production) the video FAILS ' +
+    'with "could not be produced in time" and the charge is normally refunded automatically. ' +
+    'Do not build an unattended loop on this tool.';
+/**
+ * Image-to-video dedupes on a requestId this package derives from the image bytes and the
+ * motion prompt — not on an Idempotency-Key header. The id carries no time component on
+ * purpose; the 24h bound is a continuous window on the server's lookup, so no two
+ * near-simultaneous retries can fall on different sides of it.
+ */
+export const IMAGE_TO_VIDEO_IDEMPOTENCY_HINT = 'Retry-safe: re-calling with the same image and motionPrompt returns the first job ' +
+    '(duplicate: true) for 24 hours instead of charging again. If that attempt FAILED, a retry ' +
+    'refunds the dead attempt first and then makes a new clip, so one clip is never billed ' +
+    'twice — whatever its age. In the one case where the old credits cannot be returned you get ' +
+    '409 STRANDED_CHARGE with the videoId and no new charge: report it, do not loop. Pass ' +
+    'idempotencyKey to force a separate clip from identical inputs.';
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,mBAAmB;IACnB,kBAAkB;IAClB,gBAAgB;IAChB,WAAW;IACX,WAAW;IACX,QAAQ;IACR,OAAO;CACC,CAAC;AAEX,yFAAyF;AACzF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAEpG,8BAA8B;AAC9B,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAU,CAAC;AAEnE,yEAAyE;AACzE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,EAAE;CACX,CAAC;AAEX,uFAAuF;AACvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC,aAAa,GAAG,YAAY,CAAC,eAAe,CAAC;AAE3F,MAAM,CAAC,MAAM,mBAAmB,GAC9B,SAAS,iBAAiB,aAAa,YAAY,CAAC,aAAa,YAAY;IAC7E,GAAG,YAAY,CAAC,eAAe,0DAA0D,CAAC;AAE5F,MAAM,CAAC,MAAM,SAAS,GACpB,+GAA+G;IAC/G,uFAAuF,CAAC;AAE1F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,SAAS,sBAAsB,2DAA2D;IAC1F,4FAA4F;IAC5F,8FAA8F;IAC9F,iGAAiG,CAAC;AAEpG;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,4FAA4F;IAC5F,2FAA2F;IAC3F,0FAA0F;IAC1F,+CAA+C,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAC1C,oFAAoF;IACpF,4FAA4F;IAC5F,wFAAwF;IACxF,6FAA6F;IAC7F,uFAAuF;IACvF,gEAAgE,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AutoShort API HTTP client, for the package's own resources (credit balance, rate limit).
+ * Tools do not use it: they are proxied to the remote /api/mcp registry (see proxy.ts).
+ */
+import type { RateLimitInfo } from './types.js';
+export declare class AutoShortClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    /** Last rate limit info from API response headers */
+    lastRateLimit: RateLimitInfo | null;
+    constructor(apiKey: string, baseUrl: string);
+    /** Generic API request with auth, error handling, rate limit capture */
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    getCreditBalance(): Promise<{
+        balance: number;
+        monthlyAllocation: number;
+        bonusCredits: number;
+        plan: string;
+    }>;
+}
+/** Typed API error with HTTP status and error code */
+export declare class AutoShortApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(message: string, status: number, code: string);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,qDAAqD;IAC9C,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;gBAG/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM;IAGlC,wEAAwE;IAClE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAqCpE,gBAAgB;iBACW,MAAM;2BAAqB,MAAM;sBAAgB,MAAM;cAAQ,MAAM;;CAKvG;AAED,sDAAsD;AACtD,qBAAa,iBAAkB,SAAQ,KAAK;aAGxB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAK/B"}

package/dist/client.js

@@ -0,0 +1,66 @@
+/**
+ * AutoShort API HTTP client, for the package's own resources (credit balance, rate limit).
+ * Tools do not use it: they are proxied to the remote /api/mcp registry (see proxy.ts).
+ */
+import { USER_AGENT } from './constants.js';
+export class AutoShortClient {
+    apiKey;
+    baseUrl;
+    /** Last rate limit info from API response headers */
+    lastRateLimit = null;
+    constructor(apiKey, baseUrl) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+    }
+    /** Generic API request with auth, error handling, rate limit capture */
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const res = await fetch(url, {
+            method,
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+                'User-Agent': USER_AGENT,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        // Capture rate limit headers
+        const limit = res.headers.get('x-ratelimit-limit');
+        const remaining = res.headers.get('x-ratelimit-remaining');
+        const resetAt = res.headers.get('x-ratelimit-reset');
+        if (limit && remaining && resetAt) {
+            this.lastRateLimit = {
+                limit: parseInt(limit),
+                remaining: parseInt(remaining),
+                resetAt,
+            };
+        }
+        if (!res.ok) {
+            let errorBody = {};
+            try {
+                errorBody = await res.json();
+            }
+            catch { /* empty */ }
+            const msg = errorBody.error || `API error: ${res.status} ${res.statusText}`;
+            const code = errorBody.code || `HTTP_${res.status}`;
+            throw new AutoShortApiError(msg, res.status, code);
+        }
+        return res.json();
+    }
+    // ── Credits ──
+    async getCreditBalance() {
+        return this.request('GET', '/api/v1/credits/balance');
+    }
+}
+/** Typed API error with HTTP status and error code */
+export class AutoShortApiError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'AutoShortApiError';
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,MAAM,OAAO,eAAe;IAKP;IACA;IALnB,qDAAqD;IAC9C,aAAa,GAAyB,IAAI,CAAC;IAElD,YACmB,MAAc,EACd,OAAe;QADf,WAAM,GAAN,MAAM,CAAQ;QACd,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,wEAAwE;IACxE,KAAK,CAAC,OAAO,CAAI,MAAc,EAAE,IAAY,EAAE,IAAc;QAC3D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM;YACN,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACxC,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,UAAU;aACzB;YACD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;QAEH,6BAA6B;QAC7B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACrD,IAAI,KAAK,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,GAAG;gBACnB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;gBACtB,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;gBAC9B,OAAO;aACR,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,SAAS,GAAsC,EAAE,CAAC;YACtD,IAAI,CAAC;gBAAC,SAAS,GAAG,MAAM,GAAG,CAAC,IAAI,EAAsB,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;YAC/E,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,IAAI,cAAc,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC5E,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;YACpD,MAAM,IAAI,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;IAED,gBAAgB;IAEhB,KAAK,CAAC,gBAAgB;QACpB,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EAAE,yBAAyB,CACjC,CAAC;IACJ,CAAC;CAEF;AAED,sDAAsD;AACtD,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAGxB;IACA;IAHlB,YACE,OAAe,EACC,MAAc,EACd,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/constants.d.ts

@@ -0,0 +1,11 @@
+/** Default AutoShort API base URL */
+export declare const DEFAULT_BASE_URL = "https://autoshort.org";
+/**
+ * Read from package.json so the version a client sees is the version that was published
+ * (it was hardcoded "2.0.0" while package.json said 2.1.0). `../package.json` resolves from
+ * both src/ (tests) and dist/ (the published build).
+ */
+export declare const VERSION: string;
+/** User-Agent header for API requests (the server tags videos made through it as MCP). */
+export declare const USER_AGENT: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,qCAAqC;AACrC,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,MAA2F,CAAC;AAElH,0FAA0F;AAC1F,eAAO,MAAM,UAAU,QAAoC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,12 @@
+import { createRequire } from 'node:module';
+/** Default AutoShort API base URL */
+export const DEFAULT_BASE_URL = 'https://autoshort.org';
+/**
+ * Read from package.json so the version a client sees is the version that was published
+ * (it was hardcoded "2.0.0" while package.json said 2.1.0). `../package.json` resolves from
+ * both src/ (tests) and dist/ (the published build).
+ */
+export const VERSION = createRequire(import.meta.url)('../package.json').version;
+/** User-Agent header for API requests (the server tags videos made through it as MCP). */
+export const USER_AGENT = `autoshort-mcp-server/${VERSION}`;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,qCAAqC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAY,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAElH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,OAAO,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * AutoShort MCP Server
+ *
+ * Enables AI agents (Claude, Cursor, etc.) to generate videos via AutoShort API.
+ * Usage: npx mcp-server-autoshorts --api-key sk_live_xxx
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * AutoShort MCP Server
+ *
+ * Enables AI agents (Claude, Cursor, etc.) to generate videos via AutoShort API.
+ * Usage: npx mcp-server-autoshorts --api-key sk_live_xxx
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { AutoShortClient } from './client.js';
+import { DEFAULT_BASE_URL, VERSION } from './constants.js';
+// ── Tools: proxied to the remote registry (src/app/api/mcp/tools.ts in the app) ──
+import { ListToolsRequestSchema, CallToolRequestSchema, McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { RemoteToolProxy } from './proxy.js';
+// ── Resources ──
+import { registerCreditResource } from './resources/credits.js';
+import { registerRateLimitResource } from './resources/rate-limit.js';
+// ── Prompts ──
+import { registerGenerateVideoPrompt } from './prompts/generate-video.js';
+// ── CLI arg parsing ──
+function parseArgs(argv) {
+    let apiKey = process.env.AUTOSHORT_API_KEY || '';
+    let baseUrl = DEFAULT_BASE_URL;
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === '--api-key' && argv[i + 1]) {
+            apiKey = argv[++i];
+        }
+        else if (argv[i] === '--base-url' && argv[i + 1]) {
+            baseUrl = argv[++i];
+        }
+        else if (argv[i] === '--help' || argv[i] === '-h') {
+            console.error(`autoshort-mcp-server v${VERSION}
+
+Usage: autoshort-mcp --api-key <key> [--base-url <url>]
+
+Options:
+  --api-key <key>    AutoShort API key (or set AUTOSHORT_API_KEY env var)
+  --base-url <url>   API base URL (default: ${DEFAULT_BASE_URL})
+  --help, -h         Show this help message
+
+Get your API key at: https://autoshort.org/en/developers`);
+            process.exit(0);
+        }
+    }
+    if (!apiKey) {
+        console.error('Error: API key required. Use --api-key <key> or set AUTOSHORT_API_KEY environment variable.');
+        console.error('Get your API key at: https://autoshort.org/en/developers');
+        process.exit(1);
+    }
+    return { apiKey, baseUrl };
+}
+// ── Main ──
+async function main() {
+    const { apiKey, baseUrl } = parseArgs(process.argv.slice(2));
+    const client = new AutoShortClient(apiKey, baseUrl);
+    const server = new McpServer({
+        name: 'autoshort-mcp-server',
+        version: VERSION,
+    });
+    // Tools: the remote server's registry, so stdio and the remote connector list the same set.
+    const proxy = new RemoteToolProxy(apiKey, baseUrl);
+    server.server.registerCapabilities({ tools: { listChanged: false } });
+    server.server.setRequestHandler(ListToolsRequestSchema, async () => {
+        try {
+            return { tools: await proxy.listTools() };
+        }
+        catch (e) {
+            throw new McpError(ErrorCode.InternalError, `Could not load AutoShort tools: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.server.setRequestHandler(CallToolRequestSchema, async (request) => proxy.callTool(request.params.name, (request.params.arguments ?? {})));
+    // Register resources
+    registerCreditResource(server, client);
+    registerRateLimitResource(server, client);
+    // Register prompts
+    registerGenerateVideoPrompt(server);
+    // Connect via stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/prompts/generate-video.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Video generation prompt template
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGenerateVideoPrompt(server: McpServer): void;
+//# sourceMappingURL=generate-video.d.ts.map

package/dist/prompts/generate-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-video.d.ts","sourceRoot":"","sources":["../../src/prompts/generate-video.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,QAoC5D"}

package/dist/prompts/generate-video.js

@@ -0,0 +1,38 @@
+/**
+ * Video generation prompt template
+ */
+import { z } from 'zod';
+import { API_VIDEO_COST_TEXT, CREDIT_COSTS } from '../catalog.js';
+export function registerGenerateVideoPrompt(server) {
+    server.prompt('generate_video', 'Step-by-step guide to generate an AI video with AutoShort', { topic: z.string().optional().describe('Video topic (optional — will prompt if not provided)') }, ({ topic }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Help me generate an AI video with AutoShort.${topic ? ` Topic: "${topic}"` : ''}
+
+If I already have a script or specific shots in mind, use director mode instead: agree the scenes with me,
+call autoshort_draft_video with scenes[] (free, narration read verbatim), show me the draft, and only call
+autoshort_render_draft after I approve.
+
+Steps for a quick video from a topic:
+1. First, check my credit balance with autoshort_get_credit_balance
+2. List available options with autoshort_list_niches (niches, art styles, qualities)
+3. Generate the video with autoshort_generate_video using:
+   - topic: ${topic ? `"${topic}"` : '(ask the user)'}
+   - niche: Choose the best match from available niches
+   - duration: 60 (default, good for most videos)
+   - artStyle: AUTOSHORTS (default cinematic style)
+4. Poll autoshort_get_video every 20-30 seconds until status is COMPLETED or FAILED.
+   If it returns blockedReason (e.g. INSUFFICIENT_CREDITS), stop polling and tell the user what it says.
+5. Share the video URL when done.
+6. If I want it posted: autoshort_publish_video (YouTube upload or TikTok Drafts). If the platform is not connected,
+   give me the connectUrl from autoshort_get_connection_status and poll that tool until it says connected.
+
+Credit costs: autoshort_generate_video: ${API_VIDEO_COST_TEXT} Chat videos: ${CREDIT_COSTS.videoStandard} credits with the default voice, +${CREDIT_COSTS.elevenLabsVoice} with ElevenLabs.
+If autoshort_get_credit_balance returns 403 INSUFFICIENT_SCOPE, the API key lacks "credits:read": the error says where to create a key that has it.`,
+                },
+            }],
+    }));
+}
+//# sourceMappingURL=generate-video.js.map

package/dist/prompts/generate-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-video.js","sourceRoot":"","sources":["../../src/prompts/generate-video.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElE,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,MAAM,CACX,gBAAgB,EAChB,2DAA2D,EAC3D,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC,EAAE,EACjG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,+CAA+C,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;cAUlF,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,gBAAgB;;;;;;;;;;0CAUX,mBAAmB,iBAAiB,YAAY,CAAC,aAAa,qCAAqC,YAAY,CAAC,eAAe;oJACrB;iBAC3I;aACF,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/proxy.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The stdio server's tools are the REMOTE server's tools.
+ *
+ * tools/list and tools/call are forwarded to `${baseUrl}/api/mcp` (JSON-RPC over HTTP) with the
+ * user's API key, so this package and the remote connector expose exactly the same tool names,
+ * descriptions and schemas — one registry, in the app (src/app/api/mcp/tools.ts). Before this,
+ * the package defined its own 12 tools and the remote server 5 differently named ones, and an
+ * agent saw different tools depending on how it connected.
+ *
+ * The one thing a remote server cannot do is read the user's disk, so image-to-video keeps a
+ * local convenience: `imagePath` is read here and sent as `imageBase64`.
+ *
+ * Auth and money are enforced by the server on every call (401 without a valid key, 402 before
+ * any paid work); nothing here can bypass them.
+ */
+export declare const IMAGE_TO_VIDEO_TOOL = "autoshort_generate_image_to_video";
+export declare const UPLOAD_RECORDING_TOOL = "autoshort_ugc_upload_recording";
+/** The largest image /api/videos/image-to-video accepts (IMAGE_TO_VIDEO_MAX_IMAGE_BYTES there). */
+export declare const MAX_IMAGE_BYTES: number;
+/**
+ * The largest recording this package sends inline (MAX_RECORDING_INLINE_BYTES on the server: the
+ * /api/mcp body cap leaves room for 10 MB as base64). Larger files (up to 50 MB) go by recordingUrl.
+ */
+export declare const MAX_RECORDING_BYTES: number;
+export interface RemoteTool {
+    name: string;
+    description?: string;
+    inputSchema: {
+        type: 'object';
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [k: string]: unknown;
+    };
+    annotations?: Record<string, unknown>;
+}
+export interface ToolCallResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+    [k: string]: unknown;
+}
+type FetchLike = (input: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json: () => Promise<unknown>;
+}>;
+export declare class RemoteError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+/**
+ * The remote schema, plus the stdio-only local-file alternatives: `imagePath` for image-to-video
+ * and `recordingPath` for the UGC screen recording (read here, sent as base64).
+ */
+export declare function localizeTool(tool: RemoteTool): RemoteTool;
+export declare class RemoteToolProxy {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly readLocalFile;
+    private readonly localFileSize;
+    private nextId;
+    constructor(apiKey: string, baseUrl: string, fetchImpl?: FetchLike, readLocalFile?: (path: string) => Promise<Uint8Array>, localFileSize?: (path: string) => Promise<number>);
+    private rpc;
+    listTools(): Promise<RemoteTool[]>;
+    callTool(name: string, rawArgs?: Record<string, unknown>): Promise<ToolCallResult>;
+}
+export {};
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,eAAO,MAAM,mBAAmB,sCAAsC,CAAC;AACvE,eAAO,MAAM,qBAAqB,mCAAmC,CAAC;AAEtE,mGAAmG;AACnG,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAmB,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC;IACnH,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B,CAAC,CAAC;AAEH,qBAAa,WAAY,SAAQ,KAAK;aACS,MAAM,EAAE,MAAM;gBAA/C,OAAO,EAAE,MAAM,EAAkB,MAAM,EAAE,MAAM;CAI5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CA0BzD;AAID,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAPhC,OAAO,CAAC,MAAM,CAAK;gBAGA,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,SAAyC,EACpD,aAAa,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAY,EAC/D,aAAa,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAqC;YAGzF,GAAG;IA2BX,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKlC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CA6C7F"}

package/dist/proxy.js

@@ -0,0 +1,162 @@
+/**
+ * The stdio server's tools are the REMOTE server's tools.
+ *
+ * tools/list and tools/call are forwarded to `${baseUrl}/api/mcp` (JSON-RPC over HTTP) with the
+ * user's API key, so this package and the remote connector expose exactly the same tool names,
+ * descriptions and schemas — one registry, in the app (src/app/api/mcp/tools.ts). Before this,
+ * the package defined its own 12 tools and the remote server 5 differently named ones, and an
+ * agent saw different tools depending on how it connected.
+ *
+ * The one thing a remote server cannot do is read the user's disk, so image-to-video keeps a
+ * local convenience: `imagePath` is read here and sent as `imageBase64`.
+ *
+ * Auth and money are enforced by the server on every call (401 without a valid key, 402 before
+ * any paid work); nothing here can bypass them.
+ */
+import { readFile, stat } from 'node:fs/promises';
+import { basename } from 'node:path';
+import { USER_AGENT } from './constants.js';
+export const IMAGE_TO_VIDEO_TOOL = 'autoshort_generate_image_to_video';
+export const UPLOAD_RECORDING_TOOL = 'autoshort_ugc_upload_recording';
+/** The largest image /api/videos/image-to-video accepts (IMAGE_TO_VIDEO_MAX_IMAGE_BYTES there). */
+export const MAX_IMAGE_BYTES = 10 * 1024 * 1024;
+/**
+ * The largest recording this package sends inline (MAX_RECORDING_INLINE_BYTES on the server: the
+ * /api/mcp body cap leaves room for 10 MB as base64). Larger files (up to 50 MB) go by recordingUrl.
+ */
+export const MAX_RECORDING_BYTES = 10 * 1024 * 1024;
+export class RemoteError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = 'RemoteError';
+    }
+}
+/**
+ * The remote schema, plus the stdio-only local-file alternatives: `imagePath` for image-to-video
+ * and `recordingPath` for the UGC screen recording (read here, sent as base64).
+ */
+export function localizeTool(tool) {
+    if (tool.name === IMAGE_TO_VIDEO_TOOL) {
+        const properties = { ...(tool.inputSchema.properties ?? {}) };
+        properties.imagePath = {
+            type: 'string',
+            description: 'Absolute path to a local JPG, PNG or WebP file up to 10MB (read and uploaded by this local server). Use instead of imageBase64.',
+        };
+        return {
+            ...tool,
+            inputSchema: {
+                ...tool.inputSchema,
+                properties,
+                // Either imagePath or imageBase64 — the server checks that an image arrived.
+                required: (tool.inputSchema.required ?? []).filter((r) => r !== 'imageBase64'),
+            },
+        };
+    }
+    if (tool.name === UPLOAD_RECORDING_TOOL) {
+        const properties = { ...(tool.inputSchema.properties ?? {}) };
+        properties.recordingPath = {
+            type: 'string',
+            description: 'Absolute path to a local MP4/MOV screen recording up to 10MB (read and uploaded by this local server). Larger files: pass recordingUrl.',
+        };
+        return { ...tool, inputSchema: { ...tool.inputSchema, properties } };
+    }
+    return tool;
+}
+const mb = (n) => (n / (1024 * 1024)).toFixed(1);
+export class RemoteToolProxy {
+    apiKey;
+    baseUrl;
+    fetchImpl;
+    readLocalFile;
+    localFileSize;
+    nextId = 1;
+    constructor(apiKey, baseUrl, fetchImpl = fetch, readLocalFile = readFile, localFileSize = async (p) => (await stat(p)).size) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+        this.fetchImpl = fetchImpl;
+        this.readLocalFile = readLocalFile;
+        this.localFileSize = localFileSize;
+    }
+    async rpc(method, params) {
+        const res = await this.fetchImpl(`${this.baseUrl.replace(/\/+$/, '')}/api/mcp`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+                'User-Agent': USER_AGENT,
+            },
+            body: JSON.stringify({ jsonrpc: '2.0', id: this.nextId++, method, ...(params ? { params } : {}) }),
+        });
+        let body = {};
+        try {
+            body = (await res.json());
+        }
+        catch {
+            /* non-JSON */
+        }
+        if (!res.ok) {
+            const message = typeof body.error === 'string' ? body.error : body.error?.message;
+            throw new RemoteError(message || `AutoShort returned HTTP ${res.status}`, res.status);
+        }
+        if (body.error) {
+            throw new RemoteError(typeof body.error === 'string' ? body.error : body.error.message || 'AutoShort error', res.status);
+        }
+        return body.result;
+    }
+    async listTools() {
+        const result = await this.rpc('tools/list');
+        return (result?.tools ?? []).map(localizeTool);
+    }
+    async callTool(name, rawArgs = {}) {
+        try {
+            const args = { ...rawArgs };
+            if (name === UPLOAD_RECORDING_TOOL && typeof args.recordingPath === 'string' && args.recordingPath) {
+                const size = await this.localFileSize(args.recordingPath);
+                if (size > MAX_RECORDING_BYTES) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Error: ${args.recordingPath} is ${mb(size)} MB; a local file can be sent up to ${mb(MAX_RECORDING_BYTES)} MB. Upload it somewhere public and pass recordingUrl instead (up to 50 MB). Nothing was uploaded.`,
+                            }],
+                        isError: true,
+                    };
+                }
+                const bytes = await this.readLocalFile(args.recordingPath);
+                args.recordingBase64 = Buffer.from(bytes).toString('base64');
+                if (!args.fileName)
+                    args.fileName = basename(args.recordingPath);
+                delete args.recordingPath;
+            }
+            if (name === IMAGE_TO_VIDEO_TOOL && typeof args.imagePath === 'string' && args.imagePath) {
+                // Checked before reading: a 2GB file must not be loaded into memory and base64'd only
+                // for the server to refuse it.
+                const size = await this.localFileSize(args.imagePath);
+                if (size > MAX_IMAGE_BYTES) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Error: ${args.imagePath} is ${mb(size)} MB; AutoShort accepts images up to ${mb(MAX_IMAGE_BYTES)} MB. Nothing was uploaded or charged.`,
+                            }],
+                        isError: true,
+                    };
+                }
+                const bytes = await this.readLocalFile(args.imagePath);
+                args.imageBase64 = Buffer.from(bytes).toString('base64');
+                if (!args.imageFileName)
+                    args.imageFileName = basename(args.imagePath);
+                delete args.imagePath;
+            }
+            return await this.rpc('tools/call', { name, arguments: args });
+        }
+        catch (e) {
+            const msg = e instanceof RemoteError
+                ? `Error ${e.status}: ${e.message}`
+                : `Error: ${e instanceof Error ? e.message : String(e)}`;
+            return { content: [{ type: 'text', text: msg }], isError: true };
+        }
+    }
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"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"}

package/dist/resources/credits.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Credit balance MCP resource
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AutoShortClient } from '../client.js';
+export declare function registerCreditResource(server: McpServer, client: AutoShortClient): void;
+//# sourceMappingURL=credits.d.ts.map

package/dist/resources/credits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.d.ts","sourceRoot":"","sources":["../../src/resources/credits.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAgBhF"}

package/dist/resources/credits.js

@@ -0,0 +1,16 @@
+/**
+ * Credit balance MCP resource
+ */
+export function registerCreditResource(server, client) {
+    server.resource('credit-balance', 'autoshort://credits/balance', { description: 'Current credit balance, monthly allocation, and plan tier', mimeType: 'application/json' }, async () => {
+        const balance = await client.getCreditBalance();
+        return {
+            contents: [{
+                    uri: 'autoshort://credits/balance',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(balance, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=credits.js.map

package/dist/resources/credits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.js","sourceRoot":"","sources":["../../src/resources/credits.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAuB;IAC/E,MAAM,CAAC,QAAQ,CACb,gBAAgB,EAChB,6BAA6B,EAC7B,EAAE,WAAW,EAAE,2DAA2D,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EAC1G,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAChD,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,6BAA6B;oBAClC,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvC,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources/rate-limit.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Rate limit MCP resource — exposes last-seen rate limit headers
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AutoShortClient } from '../client.js';
+export declare function registerRateLimitResource(server: McpServer, client: AutoShortClient): void;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/resources/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/resources/rate-limit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAgBnF"}

package/dist/resources/rate-limit.js

@@ -0,0 +1,16 @@
+/**
+ * Rate limit MCP resource — exposes last-seen rate limit headers
+ */
+export function registerRateLimitResource(server, client) {
+    server.resource('rate-limit', 'autoshort://usage/rate-limit', { description: 'Current API rate limit status from most recent request', mimeType: 'application/json' }, async () => {
+        const info = client.lastRateLimit ?? { limit: null, remaining: null, resetAt: null, note: 'No API requests made yet' };
+        return {
+            contents: [{
+                    uri: 'autoshort://usage/rate-limit',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(info, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/resources/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/resources/rate-limit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,MAAuB;IAClF,MAAM,CAAC,QAAQ,CACb,YAAY,EACZ,8BAA8B,EAC9B,EAAE,WAAW,EAAE,wDAAwD,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EACvG,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;QACvH,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,8BAA8B;oBACnC,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/** Video object from API */
+export interface Video {
+    id: string;
+    title: string;
+    slug: string | null;
+    status: string;
+    videoUrl: string | null;
+    thumbnailUrl: string | null;
+    duration: number | null;
+    targetDuration: number | null;
+    language: string | null;
+    artStyle: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Credit balance response */
+export interface CreditBalance {
+    balance: number;
+    monthlyAllocation: number;
+    bonusCredits: number;
+    plan: string;
+}
+/** Subscription status response */
+export interface SubscriptionStatus {
+    plan: string;
+    hasActiveSubscription: boolean;
+    videosUsed: number;
+    videosLimit: number;
+    credits: {
+        balance: number;
+        monthlyAllocation: number;
+        lastResetAt: string | null;
+    };
+}
+/** Usage stats response */
+export interface UsageStats {
+    credits: {
+        balance: number;
+        monthlyAllocation: number;
+    };
+    apiCalls: {
+        today: number;
+        total: number;
+    };
+    recentTransactions: Array<{
+        id: string;
+        type: string;
+        amount: number;
+        balance: number;
+        feature: string | null;
+        createdAt: string;
+    }>;
+}
+/** Niche/art style option */
+export interface EnumOption {
+    value: string;
+    label: string;
+}
+/** Rate limit info from API response headers */
+export interface RateLimitInfo {
+    limit: number;
+    remaining: number;
+    resetAt: string;
+}
+/** API error response */
+export interface ApiError {
+    error: string;
+    code: string;
+    details?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB,EAAE,OAAO,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACrF;AAED,2BAA2B;AAC3B,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,kBAAkB,EAAE,KAAK,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAC1D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;KAC3C,CAAC,CAAC;CACJ;AAED,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yBAAyB;AACzB,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,26 +1,50 @@
 {
   "name": "mcp-server-autoshorts",
-  "version": "1.0.0",
-  "description": "Official Model Context Protocol (MCP) server for AutoShorts — Automated faceless video generation & series management engine for AI agents",
-  "main": "index.js",
+  "version": "2.3.0",
+  "description": "MCP server for AutoShort.org \u2014 AI video generation via Claude, Cursor, and other MCP clients",
+  "mcpName": "org.autoshort/autoshort",
+  "type": "module",
+  "main": "dist/index.js",
   "bin": {
-    "mcp-server-autoshorts": "index.js"
+    "autoshort-mcp": "dist/index.js"
   },
   "scripts": {
-    "start": "node index.js"
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "keywords": [
     "mcp",
-    "model-context-protocol",
-    "autoshorts",
-    "faceless-video",
-    "youtube-shorts",
-    "tiktok-automation",
-    "ai-agent"
+    "autoshort",
+    "ai-video",
+    "claude",
+    "cursor"
   ],
-  "author": "Kien Phan <kien@autoshort.org>",
+  "author": "AutoShort (https://autoshort.org)",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/airdropfi/autoshorts"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.5.0"
-  }
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/ui": "^4.1.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "homepage": "https://autoshort.org/en/developers"
 }

package/index.js

@@ -1,85 +0,0 @@
-#!/usr/bin/env node
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import https from 'https';
-
-const server = new Server(
-  {
-    name: 'mcp-server-autoshorts',
-    version: '1.0.0',
-  },
-  {
-    capabilities: {
-      tools: {},
-    },
-  }
-);
-
-function fetchAutoShortsSeries(apiKey) {
-  return new Promise((resolve) => {
-    const req = https.request('https://autoshort.org/api/series', {
-      method: 'GET',
-      headers: {
-        'Authorization': `Bearer ${apiKey || process.env.AUTOSHORTS_API_KEY}`,
-        'User-Agent': 'mcp-server-autoshorts/1.0.0'
-      }
-    }, (res) => {
-      let data = '';
-      res.on('data', chunk => data += chunk);
-      res.on('end', () => {
-        try {
-          resolve(JSON.parse(data));
-        } catch {
-          resolve({ error: 'Failed to parse AutoShorts API response' });
-        }
-      });
-    });
-    req.on('error', (err) => resolve({ error: err.message }));
-    req.end();
-  });
-}
-
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: [
-      {
-        name: 'autoshorts_list_series',
-        description: 'List active video generation series, posting schedules, and queue statuses via AutoShorts API.',
-        inputSchema: {
-          type: 'object',
-          properties: {
-            apiKey: { type: 'string', description: 'AutoShorts API key (optional if AUTOSHORTS_API_KEY env is set)' }
-          }
-        }
-      }
-    ]
-  };
-});
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  if (request.params.name === 'autoshorts_list_series') {
-    const apiKey = request.params.arguments?.apiKey || process.env.AUTOSHORTS_API_KEY;
-    const result = await fetchAutoShortsSeries(apiKey);
-    return {
-      content: [
-        {
-          type: 'text',
-          text: JSON.stringify(result, null, 2)
-        }
-      ]
-    };
-  }
-  throw new Error(`Unknown tool: ${request.params.name}`);
-});
-
-async function run() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-run().catch((err) => {
-  console.error('Fatal MCP Server error:', err);
-  process.exit(1);
-});