Hivemind MCP

Instructions

Implementation Reference

• src/api.ts:131-148 (handler)

  The core implementation of the report_outcome tool. Sends HTTP POST to Hivemind backend (/report) with optional solution_id and required outcome (success/failure), returns confirmation.

  export async function reportOutcome(
    solutionId: number | undefined,
    outcome: "success" | "failure"
  ): Promise<OutcomeResult> {
    const response = await fetch(`${API_BASE}/report`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ solution_id: solutionId, outcome }),
    });
  
    if (!response.ok) {
      throw new Error(`Report failed: ${response.statusText}`);
    }
  
    return response.json();
  }

• src/index.ts:42-61 (schema)

  MCP tool schema defining input parameters: optional solution_id (number), required outcome (success|failure). Used in ListTools response.

  {
    name: "report_outcome",
    description:
      "Report whether a solution worked or not. Helps improve solution rankings.",
    inputSchema: {
      type: "object",
      properties: {
        solution_id: {
          type: "number",
          description: "The ID of the solution from search results.",
        },
        outcome: {
          type: "string",
          enum: ["success", "failure"],
          description: "Did the solution work?",
        },
      },
      required: ["outcome"],
    },
  },

• src/index.ts:366-374 (registration)

  MCP server registration: handles CallToolRequest for report_outcome by extracting args and invoking reportOutcome handler, returning JSON stringified result.

  case "report_outcome": {
    const result = await reportOutcome(
      args?.solution_id as number | undefined,
      args?.outcome as "success" | "failure"
    );
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }

• src/api.ts:98-101 (schema)

  TypeScript interface defining the expected return type from the reportOutcome API call.

  interface OutcomeResult {
    success: boolean;
    message: string;
  }