FedRAMP Docs MCP Server

Instructions

Implementation Reference

• src/tools/list_ksi.ts:6-33 (handler)

  Full implementation of the 'list_ksi' tool handler, including Zod input schema validation, description, and the execute function that processes input and delegates to listKsiItems.

  const schema = z.object({
    id: z.string().optional(),
    text: z.string().optional(),
    category: z.string().optional(),
    status: z.string().optional(),
    limit: z.number().int().min(1).max(200).default(100),
    offset: z.number().int().min(0).default(0),
  });
  
  export const listKsiTool: ToolDefinition<
    typeof schema,
    ReturnType<typeof listKsiItems>
  > = {
    name: "list_ksi",
    description: "List individual KSI requirement entries (like KSI-IAM-01, KSI-CNA-02) with optional filters. To see all KSI categories and their descriptions, use get_frmr_document with path 'FRMR.KSI.key-security-indicators.json' instead. This tool filters specific requirements within categories.",
    schema,
    execute: async (input) => {
      const result = listKsiItems({
        id: input.id,
        text: input.text,
        category: input.category,
        status: input.status,
        limit: input.limit ?? 100,
        offset: input.offset ?? 0,
      });
      return result;
    },
  };

• src/tools/register.ts:24-53 (registration)

  Registration of the listKsiTool (among other tools) in the MCP server via registerToolDefs.

  export function registerTools(server: McpServer): void {
    registerToolDefs(server, [
      // Document discovery
      listFrmrDocumentsTool,
      getFrmrDocumentTool,
      listVersionsTool,
      // KSI tools
      listKsiTool,
      getKsiTool,
      filterByImpactTool,
      getThemeSummaryTool,
      getEvidenceExamplesTool,
      // Control mapping tools
      listControlsTool,
      getControlRequirementsTool,
      analyzeControlCoverageTool,
      // Search & lookup tools
      searchMarkdownTool,
      readMarkdownTool,
      searchDefinitionsTool,
      getRequirementByIdTool,
      // Analysis tools
      diffFrmrTool,
      grepControlsTool,
      significantChangeTool,
      // System tools
      healthCheckTool,
      updateRepositoryTool,
    ]);
  }

• src/frmr.ts:56-106 (helper)

  Supporting types (ListKsiOptions), helper function (textMatches), and core listKsiItems implementation that performs filtering and pagination on KSI items fetched from getKsiItems().

  export interface ListKsiOptions {
    id?: string;
    text?: string;
    category?: string;
    status?: string;
    limit: number;
    offset: number;
  }
  
  function textMatches(haystack: string | undefined, needle: string): boolean {
    if (!haystack) {
      return false;
    }
    return haystack.toLowerCase().includes(needle.toLowerCase());
  }
  
  export function listKsiItems(
    options: ListKsiOptions,
  ): { total: number; items: KsiItem[] } {
    const all = getKsiItems();
    const filtered = all.filter((item) => {
      if (options.id && item.id !== options.id) {
        return false;
      }
      if (
        options.text &&
        !(
          textMatches(item.title, options.text) ||
          textMatches(item.description, options.text)
        )
      ) {
        return false;
      }
      if (
        options.category &&
        !textMatches(item.category, options.category)
      ) {
        return false;
      }
      if (
        options.status &&
        options.status !== item.status
      ) {
        return false;
      }
      return true;
    });
    const total = filtered.length;
    const items = filtered.slice(options.offset, options.offset + options.limit);
    return { total, items };
  }