vyra-mcp 0.4.0 → 0.5.0

package/dist/api.js

@@ -55,6 +55,12 @@ export async function apiRequest(method, path, body) {
         }
     }
     if (!res.ok) {
+        // A 401 here means a key was sent but rejected — point the user at the fix
+        // instead of surfacing the bare "Invalid or missing API key" envelope.
+        if (res.status === 401) {
+            throw new Error("Vyra rejected the API key (HTTP 401). Generate a fresh key in " +
+                "Settings → Developers and re-run `npx vyra-mcp connect <your-key>`.");
+        }
         const message = json?.error ??
             `HTTP ${res.status} from Vyra`;
         throw new Error(message);

package/dist/server.js

@@ -38,8 +38,92 @@ async function run(fn) {
         return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
     }
 }
+// Campaign draft fields, shared by create_campaign and update_campaign so the
+// two never drift. Money fields are integer cents.
+const CAMPAIGN_FIELDS = {
+    name: z.string().describe("Campaign name"),
+    fixed_fee_cents: z
+        .number()
+        .int()
+        .describe("Guaranteed fee paid to each creator on approval, in cents"),
+    budget_cents: z.number().int().describe("Total campaign budget in cents"),
+    objective: z.string().optional().describe("Short objective/goal"),
+    platform: z
+        .enum(["tiktok", "instagram", "youtube"])
+        .optional()
+        .describe("Target platform (default tiktok)"),
+    countries: z
+        .array(z.string())
+        .optional()
+        .describe("Allowed 2-letter country codes"),
+    bonus_cap_cents: z
+        .number()
+        .int()
+        .optional()
+        .describe("Max performance bonus per creator, in cents"),
+    bonus_type: z.enum(["milestone", "cpm", "none"]).optional(),
+    bonus_cpm_cents: z
+        .number()
+        .int()
+        .optional()
+        .describe("Bonus per 1000 views, in cents (when bonus_type is cpm)"),
+    languages: z
+        .array(z.string())
+        .optional()
+        .describe("Allowed creator languages"),
+    min_followers: z.number().int().optional(),
+    max_followers: z.number().int().optional(),
+    min_quality_score: z
+        .number()
+        .int()
+        .min(0)
+        .max(100)
+        .optional()
+        .describe("Minimum AI quality score (0–100) a submission must hit"),
+    require_connected_account: z
+        .boolean()
+        .optional()
+        .describe("Require creators to have a connected social account"),
+    watch_window_days: z
+        .number()
+        .int()
+        .optional()
+        .describe("Days to track views before the bonus settles"),
+    submission_deadline_hours: z
+        .number()
+        .int()
+        .optional()
+        .describe("Hours a creator has to post after joining"),
+    min_video_seconds: z
+        .number()
+        .int()
+        .optional()
+        .describe("Minimum video length, in seconds"),
+    max_video_seconds: z
+        .number()
+        .int()
+        .optional()
+        .describe("Maximum video length, in seconds"),
+    key_message: z
+        .string()
+        .optional()
+        .describe("The brief / what creators should communicate"),
+    hashtags: z.array(z.string()).optional(),
+    promo_link: z
+        .string()
+        .optional()
+        .describe("A link OR a plain discount code (e.g. SAVE20)"),
+    assets: z
+        .array(z.object({
+        kind: z.enum(["logo", "video", "screenshot"]),
+        url: z.string().describe("Hosted URL of the asset"),
+        file_name: z.string().optional(),
+    }))
+        .optional()
+        .describe("Brand assets to attach, by URL (logo/demo video/screenshots)"),
+};
 export function buildServer() {
-    const server = new McpServer({ name: "vyra", version: "0.3.0" }, { instructions: INSTRUCTIONS });
+    const server = new McpServer({ name: "vyra", version: "0.5.0" }, { instructions: INSTRUCTIONS });
     // --- Orientation --------------------------------------------------------
     // One call an agent makes first to ground itself: live state + how Vyra works
     // + exactly what a campaign needs. Stops it from asking irrelevant questions.
@@ -88,6 +172,17 @@ export function buildServer() {
         description: "Get the brand's available prepaid balance (in cents and USD). Use before activating a campaign to confirm funds.",
         inputSchema: {},
     }, () => run(() => apiRequest("GET", "/wallet")));
+    server.registerTool("create_topup_link", {
+        title: "Add credits (Stripe checkout link)",
+        description: "Start a Stripe Checkout to add credits to the wallet and return the hosted URL. Card payment happens in the browser (a card can't be charged headlessly), so give the user the link to open once — the balance updates automatically after payment. 1 credit = $1. Use this when activate_campaign reports insufficient funds.",
+        inputSchema: {
+            credits: z
+                .number()
+                .int()
+                .min(1)
+                .describe("Credits to add (1 credit = $1)"),
+        },
+    }, ({ credits }) => run(() => apiRequest("POST", "/wallet/topup", { credits })));
     // --- Campaigns: read ----------------------------------------------------
     server.registerTool("list_campaigns", {
         title: "List campaigns",
@@ -136,58 +231,13 @@ export function buildServer() {
     server.registerTool("create_campaign", {
         title: "Create campaign (draft)",
         description: "Create a new draft campaign. It is NOT live yet — call activate_campaign after funding. All money fields are integer cents.",
-        inputSchema: {
-            name: z.string().describe("Campaign name"),
-            fixed_fee_cents: z
-                .number()
-                .int()
-                .describe("Guaranteed fee paid to each creator on approval, in cents"),
-            budget_cents: z
-                .number()
-                .int()
-                .describe("Total campaign budget in cents"),
-            objective: z.string().optional().describe("Short objective/goal"),
-            platform: z
-                .enum(["tiktok", "instagram", "youtube"])
-                .optional()
-                .describe("Target platform (default tiktok)"),
-            countries: z
-                .array(z.string())
-                .optional()
-                .describe("Allowed 2-letter country codes"),
-            bonus_cap_cents: z
-                .number()
-                .int()
-                .optional()
-                .describe("Max performance bonus per creator, in cents"),
-            bonus_type: z.enum(["milestone", "cpm", "none"]).optional(),
-            bonus_cpm_cents: z
-                .number()
-                .int()
-                .optional()
-                .describe("Bonus per 1000 views, in cents (when bonus_type is cpm)"),
-            min_followers: z.number().int().optional(),
-            watch_window_days: z
-                .number()
-                .int()
-                .optional()
-                .describe("Days to track views before the bonus settles"),
-            key_message: z
-                .string()
-                .optional()
-                .describe("The brief / what creators should communicate"),
-            hashtags: z.array(z.string()).optional(),
-            promo_link: z.string().optional(),
-            assets: z
-                .array(z.object({
-                kind: z.enum(["logo", "video", "screenshot"]),
-                url: z.string().describe("Hosted URL of the asset"),
-                file_name: z.string().optional(),
-            }))
-                .optional()
-                .describe("Brand assets to attach, by URL (logo/demo video/screenshots)"),
-        },
+        inputSchema: CAMPAIGN_FIELDS,
     }, (args) => run(() => apiRequest("POST", "/campaigns", args)));
+    server.registerTool("update_campaign", {
+        title: "Update campaign (draft only)",
+        description: "Edit a DRAFT campaign's fields (only drafts can be edited — a live campaign can't be changed). Pass the full set of fields the draft should have; money fields are integer cents.",
+        inputSchema: { campaign_id: z.string().describe("The campaign id"), ...CAMPAIGN_FIELDS },
+    }, ({ campaign_id, ...fields }) => run(() => apiRequest("PATCH", `/campaigns/${campaign_id}`, fields)));
     server.registerTool("list_campaign_assets", {
         title: "List campaign assets",
         description: "List the brand assets (logo, demo video, screenshots) attached to a campaign.",
@@ -223,6 +273,20 @@ export function buildServer() {
             campaign_id: z.string().describe("The campaign id to pause"),
         },
     }, ({ campaign_id }) => run(() => apiRequest("POST", `/campaigns/${campaign_id}/pause`)));
+    server.registerTool("cancel_campaign", {
+        title: "Cancel campaign",
+        description: "Close a campaign. Releases the reserved budget for unfilled slots back to the wallet and refunds join fees to creators who joined but won't earn. Cannot be undone.",
+        inputSchema: {
+            campaign_id: z.string().describe("The campaign id to cancel"),
+        },
+    }, ({ campaign_id }) => run(() => apiRequest("POST", `/campaigns/${campaign_id}/cancel`)));
+    server.registerTool("get_campaign_report", {
+        title: "Get campaign report",
+        description: "Performance report for a campaign: creators joined, videos live, approval rate, verified views, engagement, the views trend, and a per-submission breakdown.",
+        inputSchema: {
+            campaign_id: z.string().describe("The campaign id"),
+        },
+    }, ({ campaign_id }) => run(() => apiRequest("GET", `/campaigns/${campaign_id}/report`)));
     return server;
 }
 // Start the server on stdio (how MCP clients spawn it as a child process).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vyra-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Drive Vyra from Claude, ChatGPT, or any MCP client — manage performance-based creator campaigns in plain English.",
   "license": "MIT",
   "type": "module",