BBQ MCP Server

Instructions

Implementation Reference

• src/index.ts:458-497 (handler)

  Main handler function for bbq_list_proteins tool. Filters PROTEIN_PROFILES by category, handles JSON or Markdown output, and uses formatting helper.

  async (params: ListProteinsInput) => {
    try {
      let proteins = Object.values(PROTEIN_PROFILES);
  
      if (params.category !== "all") {
        proteins = proteins.filter((p) => p.category === params.category);
      }
  
      if (params.response_format === "json") {
        const output = {
          category: params.category,
          count: proteins.length,
          proteins: proteins.map((p) => ({
            type: p.type,
            displayName: p.displayName,
            category: p.category,
            usdaSafeTemp: p.usdaSafeTemp,
            recommendedMethods: p.recommendedMethods,
            hasStall: !!p.stallRange,
            donenessOptions: Object.keys(p.donenessTemps),
          })),
        };
  
        return {
          content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
          structuredContent: output,
        };
      }
  
      const markdown = formatProteinListMarkdown(proteins, params.category);
      return {
        content: [{ type: "text", text: markdown }],
      };
    } catch (error) {
      const message = error instanceof Error ? error.message : "Unknown error occurred";
      return {
        isError: true,
        content: [{ type: "text", text: `Error listing proteins: ${message}` }],
      };
    }

• src/schemas/index.ts:143-153 (schema)

  Zod input schema for bbq_list_proteins defining category filter and response format.

  export const ListProteinsSchema = z
    .object({
      category: z
        .enum(["beef", "pork", "poultry", "lamb", "seafood", "all"])
        .default("all")
        .describe("Filter by protein category"),
      response_format: ResponseFormatSchema.describe("Output format"),
    })
    .strict();
  
  export type ListProteinsInput = z.infer<typeof ListProteinsSchema>;

• src/index.ts:435-457 (registration)

  Primary registration of the bbq_list_proteins tool with MCP server including title, description, schema, and annotations.

  server.registerTool(
    "bbq_list_proteins",
    {
      title: "List Supported Proteins",
      description: `List all supported protein types with their key cooking information.
  
  Use this to discover available proteins and their identifiers for use with other tools.
  
  Args:
    - category: Filter by category ('beef', 'pork', 'poultry', 'lamb', 'seafood', 'all')
    - response_format: 'markdown' or 'json'
  
  Examples:
    - "What meats can you help me cook?" -> category='all'
    - "Show me beef options" -> category='beef'`,
      inputSchema: ListProteinsSchema,
      annotations: {
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: false,
      },
    },

• src/services/formatting.ts:141-179 (helper)

  Helper function to format the filtered protein list into grouped Markdown output with key info like targets, methods, and stall warnings.

  export function formatProteinListMarkdown(
    proteins: ProteinProfile[],
    category?: string
  ): string {
    const categoryDisplay = category === "all" ? "All Proteins" : `${category?.charAt(0).toUpperCase()}${category?.slice(1)}`;
  
    let output = `## 🥩 ${categoryDisplay}\n\n`;
  
    // Group by category
    const grouped = proteins.reduce(
      (acc, protein) => {
        if (!acc[protein.category]) {
          acc[protein.category] = [];
        }
        acc[protein.category].push(protein);
        return acc;
      },
      {} as Record<string, ProteinProfile[]>
    );
  
    for (const [cat, prots] of Object.entries(grouped)) {
      output += `### ${cat.charAt(0).toUpperCase() + cat.slice(1)}\n\n`;
  
      for (const protein of prots) {
        const doneness = Object.keys(protein.donenessTemps)[0] as DonenessLevel;
        const temp = protein.donenessTemps[doneness];
  
        output += `**${protein.displayName}** (\`${protein.type}\`)\n`;
        output += `- Target: ${temp}°F (${DONENESS_INFO[doneness]?.displayName || doneness})\n`;
        output += `- Methods: ${protein.recommendedMethods.map((m) => COOK_METHOD_INFO[m].displayName).join(", ")}\n`;
        if (protein.stallRange) {
          output += `- ⚠️ Stalls at ${protein.stallRange.start}-${protein.stallRange.end}°F\n`;
        }
        output += "\n";
      }
    }
  
    return output;
  }

• src/smithery.ts:180-189 (registration)

  Alternative simplified registration for Smithery compatibility using inline Zod schema and getProteinsByCategory helper.

  server.tool(
    "bbq_list_proteins",
    "List all supported proteins",
    { category: z.enum(["all", "beef", "pork", "poultry", "lamb", "seafood"]).default("all") },
    async ({ category }) => {
      const proteins = getProteinsByCategory(category);
      const markdown = formatProteinListMarkdown(proteins, category);
      return { content: [{ type: "text", text: markdown }] };
    }
  );