brandomica-mcp-server

Instructions

Implementation Reference

• src/index.ts:369-388 (handler)

  The tool 'brandomica_filing_readiness' is registered here. It takes a brand_name and mode, calls the 'filing-readiness' API endpoint, and returns the response as a JSON string.

  server.registerTool(
    "brandomica_filing_readiness",
    {
      title: "Filing Readiness Summary",
      description:
        "Return a decision-focused filing readiness block with verdict, filing risk, top conflicts by jurisdiction/class, evidence links, confidence, and missing critical categories.",
      inputSchema: z.object({
        ...brandNameInput,
        mode: z.enum(["full", "quick"]).default("full").describe("Check mode: full (default) for filing decisions, quick for faster directional output"),
      }).strict(),
      annotations: toolAnnotations,
    },
    async ({ brand_name, mode }) => {
      const extra = mode && mode !== "full" ? { mode } : undefined;
      const data = (await fetchApi("filing-readiness", brand_name, extra)) as FilingReadinessResponse;
      return {
        content: [{ type: "text" as const, text: JSON.stringify(data) }],
      };
    }
  );

• src/index.ts:163-188 (schema)

  Type definitions (schema) for the filing readiness response and its internal components.

  interface FilingReadinessConflictSummary {
    severity: "high" | "medium" | "low";
    source: string;
    jurisdiction?: string;
    description: string;
    whyItMatters: string;
    evidenceUrl?: string;
    classes?: number[];
  }
  
  interface FilingReadinessSummary {
    verdict: "ready" | "caution" | "blocked";
    filingRisk: "go" | "caution" | "stop";
    gateStatus: "ready" | "caution" | "blocked";
    confidence: "high" | "medium" | "low";
    missingCriticalCategories: string[];
    topConflicts: FilingReadinessConflictSummary[];
    actions: string[];
  }
  
  interface FilingReadinessResponse {
    name: string;
    mode: "full" | "quick";
    checkedAt: string;
    filingReadiness: FilingReadinessSummary;
  }