@motiblog/mcp 0.1.1 → 0.1.2

package/dist/index.js

@@ -483,7 +483,7 @@ var toolDefinitions = [
     name: "get_digest",
     description: "One-call morning check-in for a project: article counts by lifecycle status, the REVIEW queue (what is waiting to be published, with word counts), posts published in the last 7 days, content plans due in the next 7 days, the latest published post, quota usage, and the project's current autonomy level (L1 = nothing ships without agent review; L2 = clean articles auto-publish). Start every check-in here.",
     inputSchema: { ...projectIdArg },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "Morning Digest", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const [project, articles, plans] = await Promise.all([
@@ -500,7 +500,7 @@ var toolDefinitions = [
     name: "list_projects",
     description: "List every MotiBlog project the API key can access, with settings that matter to agents: requireApproval (REVIEW vs APPROVED after generation), autoPublish, factCheckStrict, selfHostedBlog, and article quota usage.",
     inputSchema: {},
-    annotations: { readOnlyHint: true },
+    annotations: { title: "List Projects", readOnlyHint: true, destructiveHint: false },
     async handler(_args, ctx) {
       return json(await ctx.client.listProjects());
     }
@@ -509,7 +509,7 @@ var toolDefinitions = [
     name: "get_project",
     description: "Get one MotiBlog project in detail: pipeline settings (aiModel, language, internalLinks, banner), positioning inputs (businessProfile, productTruth, manualPositioning) and quota state.",
     inputSchema: { ...projectIdArg },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "Project Details", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       return json(await ctx.client.getProject(resolveProjectId(ctx, args.project_id)));
     }
@@ -519,6 +519,7 @@ var toolDefinitions = [
     name: "start_pipeline",
     description: "Start the autonomous pipeline for a project: site crawl/analysis \u2192 topic selection \u2192 article generation for scheduled plans. Returns immediately; poll get_pipeline_status or list_articles(status=GENERATING) to follow progress.",
     inputSchema: { ...projectIdArg },
+    annotations: { title: "Start Content Pipeline", readOnlyHint: false, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(await ctx.client.pipelineStart(projectId));
@@ -528,7 +529,7 @@ var toolDefinitions = [
     name: "get_pipeline_status",
     description: "Get current pipeline run state for a project: whether a run is active, its steps, and recent run history. Use after start_pipeline or generate_article.",
     inputSchema: { ...projectIdArg },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "Pipeline Status", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       return json(
         await ctx.client.pipelineStatus(resolveProjectId(ctx, args.project_id))
@@ -543,6 +544,7 @@ var toolDefinitions = [
       topic: import_zod.z.string().min(1).describe('The proposed topic/title, e.g. "How headless CMSs serve AI agents"'),
       ...projectIdArg
     },
+    annotations: { title: "Suggest Topics", readOnlyHint: false, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(await ctx.client.createContentPlanFromGap(projectId, String(args.topic)));
@@ -552,7 +554,7 @@ var toolDefinitions = [
     name: "list_content_plans",
     description: "List the content plan queue for a project with each entry status: DRAFT (proposed), APPROVED (cleared for generation), IN_PROGRESS, COMPLETED.",
     inputSchema: { ...projectIdArg },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "List Content Plans", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       return json(await ctx.client.listContentPlans(resolveProjectId(ctx, args.project_id)));
     }
@@ -564,6 +566,7 @@ var toolDefinitions = [
       plan_id: import_zod.z.string().describe("Content plan entry id (from list_content_plans)"),
       ...projectIdArg
     },
+    annotations: { title: "Approve Content Plan", readOnlyHint: false, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(await ctx.client.approveContentPlan(projectId, String(args.plan_id)));
@@ -576,6 +579,7 @@ var toolDefinitions = [
       plan_id: import_zod.z.string().describe("Content plan entry id"),
       ...projectIdArg
     },
+    annotations: { title: "Regenerate Content Plan", readOnlyHint: false, destructiveHint: true },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(await ctx.client.regenerateContentPlan(projectId, String(args.plan_id)));
@@ -588,6 +592,7 @@ var toolDefinitions = [
       plan_id: import_zod.z.string().describe("Content plan entry id (must be APPROVED)"),
       ...projectIdArg
     },
+    annotations: { title: "Generate Article", readOnlyHint: false, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(await ctx.client.generateArticleFromPlan(projectId, String(args.plan_id)));
@@ -601,7 +606,7 @@ var toolDefinitions = [
       end_date: import_zod.z.string().describe("ISO date, e.g. 2026-09-30"),
       ...projectIdArg
     },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "Content Calendar", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(
@@ -621,7 +626,7 @@ var toolDefinitions = [
       status: import_zod.z.enum(ARTICLE_STATUSES).optional().describe("Filter by lifecycle status (default REVIEW)"),
       ...projectIdArg
     },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "Review Queue", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const status = typeof args.status === "string" ? args.status : "REVIEW";
@@ -637,7 +642,7 @@ var toolDefinitions = [
       include_logs: import_zod.z.boolean().optional().describe("Include pipeline phase logs (default false)"),
       ...projectIdArg
     },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "Get Article", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const article = await ctx.client.getArticle(projectId, String(args.article_id));
@@ -659,6 +664,7 @@ var toolDefinitions = [
       status: import_zod.z.enum(["DRAFT", "REVIEW", "APPROVED"]).optional(),
       ...projectIdArg
     },
+    annotations: { title: "Update Article", readOnlyHint: false, destructiveHint: true },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const patch = {};
@@ -677,6 +683,12 @@ var toolDefinitions = [
       publish_now: import_zod.z.boolean().optional().describe("Also trigger publishing now (default false)"),
       ...projectIdArg
     },
+    annotations: {
+      title: "Approve & Publish",
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const articleId = String(args.article_id);
@@ -695,6 +707,7 @@ var toolDefinitions = [
       clear_schedule: import_zod.z.boolean().optional().describe("Clear any scheduled date instead of setting one"),
       ...projectIdArg
     },
+    annotations: { title: "Schedule Publication", readOnlyHint: false, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const value = args.clear_schedule === true ? null : args.scheduled_for ?? null;
@@ -709,7 +722,7 @@ var toolDefinitions = [
       article_id: import_zod.z.string().describe("Article id"),
       ...projectIdArg
     },
-    annotations: { destructiveHint: true },
+    annotations: { title: "Regenerate Article", readOnlyHint: false, destructiveHint: true },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(await ctx.client.regenerateArticle(projectId, String(args.article_id)));
@@ -723,6 +736,7 @@ var toolDefinitions = [
       chapter_index: import_zod.z.number().int().min(0).describe("Zero-based chapter index"),
       ...projectIdArg
     },
+    annotations: { title: "Regenerate Chapter", readOnlyHint: false, destructiveHint: true },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(
@@ -741,7 +755,7 @@ var toolDefinitions = [
       article_id: import_zod.z.string().describe("Article id"),
       ...projectIdArg
     },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "Pipeline Logs", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(await ctx.client.getPipelineLogs(projectId, String(args.article_id)));
@@ -751,7 +765,7 @@ var toolDefinitions = [
     name: "list_refresh_suggestions",
     description: "Across ALL your projects: published articles whose Search Console stats suggest they are decaying and would benefit from a refresh. Feed these back into planning via suggest_topics or update_article.",
     inputSchema: {},
-    annotations: { readOnlyHint: true },
+    annotations: { title: "Refresh Suggestions", readOnlyHint: true, destructiveHint: false },
     async handler(_args, ctx) {
       return json(await ctx.client.listRefreshSuggestions());
     }
@@ -761,7 +775,7 @@ var toolDefinitions = [
     name: "list_integrations",
     description: "List configured publishing targets (integrations) for a project: WEBHOOK, WORDPRESS, GHOST, WEBFLOW, SHOPIFY, DEVTO, SANITY, CUSTOM_API \u2014 with enabled state.",
     inputSchema: { ...projectIdArg },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "List Integrations", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const integrations = await ctx.client.listIntegrations(projectId);
@@ -778,6 +792,12 @@ var toolDefinitions = [
       method: import_zod.z.enum(["POST", "PUT", "PATCH"]).optional().describe("HTTP method (default POST)"),
       ...projectIdArg
     },
+    annotations: {
+      title: "Create Webhook Integration",
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: true
+    },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const config = { url: String(args.url) };
@@ -801,6 +821,12 @@ var toolDefinitions = [
       mode: import_zod.z.enum(["ping", "full"]).optional(),
       ...projectIdArg
     },
+    annotations: {
+      title: "Test Integration",
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: true
+    },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(
@@ -820,6 +846,12 @@ var toolDefinitions = [
       integration_id: import_zod.z.string().describe("Target integration id"),
       ...projectIdArg
     },
+    annotations: {
+      title: "Publish to CMS",
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(
@@ -839,6 +871,12 @@ var toolDefinitions = [
       integration_id: import_zod.z.string(),
       ...projectIdArg
     },
+    annotations: {
+      title: "Retry Publish",
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(
@@ -858,7 +896,7 @@ var toolDefinitions = [
       limit: import_zod.z.number().int().min(1).max(200).optional(),
       ...projectIdArg
     },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "Publish Logs", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(
@@ -875,7 +913,7 @@ var toolDefinitions = [
     name: "list_keywords",
     description: "List tracked keywords for a project (search volume, difficulty, intent, status). Keywords drive topic relevance in generation.",
     inputSchema: { ...projectIdArg },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "List Keywords", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       return json(await ctx.client.listKeywords(resolveProjectId(ctx, args.project_id)));
     }
@@ -890,6 +928,7 @@ var toolDefinitions = [
       intent: import_zod.z.enum(["INFORMATIONAL", "NAVIGATIONAL", "TRANSACTIONAL", "COMMERCIAL"]).optional(),
       ...projectIdArg
     },
+    annotations: { title: "Add Keyword", readOnlyHint: false, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(
@@ -909,7 +948,7 @@ var toolDefinitions = [
       active_only: import_zod.z.boolean().optional().describe("Only active facts (default false = all)"),
       ...projectIdArg
     },
-    annotations: { readOnlyHint: true },
+    annotations: { title: "List Product Facts", readOnlyHint: true, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       return json(
@@ -927,6 +966,7 @@ var toolDefinitions = [
       active: import_zod.z.boolean().optional().describe("Set active flag when updating"),
       ...projectIdArg
     },
+    annotations: { title: "Supply Product Fact", readOnlyHint: false, destructiveHint: false },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const category = Array.isArray(args.category) ? args.category.map(String) : void 0;
@@ -957,6 +997,12 @@ var toolDefinitions = [
       limit: import_zod.z.number().int().min(1).max(500).optional().describe("Max articles to export (default 100)"),
       ...projectIdArg
     },
+    annotations: {
+      title: "Export Blog to Files",
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    },
     async handler(args, ctx) {
       const projectId = resolveProjectId(ctx, args.project_id);
       const status = typeof args.status === "string" ? args.status : "PUBLISHED";
@@ -993,10 +1039,12 @@ function buildServer(config) {
     register(
       tool.name,
       {
-        title: tool.name,
+        // The human-readable title, not the wire name — a picker showing
+        // "approve_publication" tells a person nothing about what it does.
+        title: tool.annotations.title,
         description: tool.description,
         inputSchema: tool.inputSchema,
-        ...tool.annotations ? { annotations: tool.annotations } : {}
+        annotations: tool.annotations
       },
       async (args) => {
         let result;