@motiblog/mcp 0.1.0 → 0.1.2

package/dist/lib.js

@@ -495,7 +495,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([
@@ -512,7 +512,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());
     }
@@ -521,7 +521,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)));
     }
@@ -531,6 +531,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));
@@ -540,7 +541,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))
@@ -555,6 +556,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)));
@@ -564,7 +566,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)));
     }
@@ -576,6 +578,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)));
@@ -588,6 +591,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)));
@@ -600,6 +604,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)));
@@ -613,7 +618,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(
@@ -633,7 +638,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";
@@ -649,7 +654,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));
@@ -671,6 +676,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 = {};
@@ -689,6 +695,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);
@@ -707,6 +719,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;
@@ -721,7 +734,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)));
@@ -735,6 +748,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(
@@ -753,7 +767,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)));
@@ -763,7 +777,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());
     }
@@ -773,7 +787,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);
@@ -790,6 +804,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) };
@@ -813,6 +833,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(
@@ -832,6 +858,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(
@@ -851,6 +883,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(
@@ -870,7 +908,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(
@@ -887,7 +925,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)));
     }
@@ -902,6 +940,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(
@@ -921,7 +960,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(
@@ -939,6 +978,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;
@@ -969,6 +1009,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";
@@ -1005,10 +1051,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;