Claude Writer's Aid MCP

Instructions

Implementation Reference

• src/tools/WriterToolHandlers.ts:442-463 (handler)

  Tool handler function that extracts arguments and delegates to WritersAid.addStyleDecision

  private async addStyleDecision(args: Record<string, unknown>) {
    const category = args.category as
      | "terminology"
      | "formatting"
      | "citations"
      | "tone"
      | "headings"
      | "lists"
      | "code_blocks"
      | "quotes"
      | "other";
    const canonicalChoice = args.canonical_choice as string;
    const rationale = args.rationale as string | undefined;
    const examples = args.examples as string[] | undefined;
  
    return this.writersAid.addStyleDecision({
      category,
      canonicalChoice,
      rationale,
      examples,
    });
  }

• src/tools/WriterToolDefinitions.ts:438-459 (schema)

  Input schema and description for the add_style_decision tool

    name: "add_style_decision",
    description: "Record a style decision for consistency",
    inputSchema: {
      type: "object",
      properties: {
        project_path: { type: "string", description: "Path to manuscript directory (defaults to current directory)" },
        category: {
          type: "string",
          enum: ["terminology", "formatting", "citations", "tone", "headings", "lists", "code_blocks", "quotes", "other"],
          description: "Style category",
        },
        canonical_choice: { type: "string", description: "The chosen canonical form" },
        rationale: { type: "string", description: "Why this choice was made" },
        examples: {
          type: "array",
          items: { type: "string" },
          description: "Example usages",
        },
      },
      required: ["category", "canonical_choice"],
    },
  },

• src/tools/WriterToolHandlers.ts:80-81 (registration)

  Tool registration in the handleTool switch statement

  case "add_style_decision":
    return this.addStyleDecision(args);

• src/memory/RequirementsManager.ts:203-232 (helper)

  Core implementation that persists the style decision to the database

  addStyleDecision(
    decision: Omit<StyleDecision, "id" | "createdAt">
  ): StyleDecision {
    const now = Date.now();
    const newDecision: StyleDecision = {
      id: nanoid(),
      ...decision,
      createdAt: now,
    };
  
    this.db
      .prepare(
        `INSERT INTO style_decisions
         (id, category, canonical_choice, alternatives_rejected, rationale, examples, created_at)
         VALUES (?, ?, ?, ?, ?, ?, ?)`
      )
      .run(
        newDecision.id,
        newDecision.category,
        newDecision.canonicalChoice,
        newDecision.alternativesRejected
          ? JSON.stringify(newDecision.alternativesRejected)
          : null,
        newDecision.rationale || null,
        newDecision.examples ? JSON.stringify(newDecision.examples) : null,
        newDecision.createdAt
      );
  
    return newDecision;
  }

• src/WritersAid.ts:601-630 (helper)

  Delegation method in WritersAid that calls RequirementsManager and formats response

  addStyleDecision(options: {
    category:
      | "terminology"
      | "formatting"
      | "citations"
      | "tone"
      | "headings"
      | "lists"
      | "code_blocks"
      | "quotes"
      | "other";
    canonicalChoice: string;
    rationale?: string;
    examples?: string[];
  }) {
    const decision = this.requirementsManager.addStyleDecision({
      category: options.category,
      canonicalChoice: options.canonicalChoice,
      rationale: options.rationale,
      examples: options.examples,
    });
  
    return {
      id: decision.id,
      category: decision.category,
      canonicalChoice: decision.canonicalChoice,
      rationale: decision.rationale,
      examples: decision.examples,
    };
  }