Hivemind MCP

Instructions

Implementation Reference

• src/index.ts:100-114 (schema)

  Input schema definition for the 'get_skill' tool, specifying skill_id as required number input.

  {
    name: "get_skill",
    description:
      "Get detailed information about a specific skill including full instructions and executable steps.",
    inputSchema: {
      type: "object",
      properties: {
        skill_id: {
          type: "number",
          description: "The ID of the skill to retrieve",
        },
      },
      required: ["skill_id"],
    },
  },

• src/index.ts:394-399 (registration)

  MCP server registration and dispatch handler for 'get_skill' tool call, invokes getSkill function from api.ts.

  case "get_skill": {
    const result = await getSkill(args?.skill_id as number);
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }

• src/api.ts:248-262 (handler)

  Core handler implementation: Calls Supabase edge function /skill endpoint with skill_id to retrieve skill details from database.

  export async function getSkill(skillId: number): Promise<SkillDetailResult> {
    const response = await fetch(`${API_BASE}/skill`, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ skill_id: skillId }),
    });
  
    if (!response.ok) {
      throw new Error(`Get skill failed: ${response.statusText}`);
    }
  
    return response.json();
  }

• supabase/functions/public/index.ts:376-406 (handler)

  Backend Supabase edge function handler: Queries 'knowledge_entries' table for skill by id and type='skill', returns full record.

  async function handleGetSkill(supabase: any, body: any, corsHeaders: any) {
    const { skill_id } = body;
  
    if (!skill_id) {
      return new Response(JSON.stringify({ error: 'skill_id required' }), {
        status: 400,
        headers: { ...corsHeaders, 'Content-Type': 'application/json' }
      });
    }
  
    const { data, error } = await supabase
      .from('knowledge_entries')
      .select('*')
      .eq('id', skill_id)
      .eq('type', 'skill')
      .single();
  
    if (error || !data) {
      return new Response(JSON.stringify({ error: 'Skill not found' }), {
        status: 404,
        headers: { ...corsHeaders, 'Content-Type': 'application/json' }
      });
    }
  
    return new Response(JSON.stringify({
      ...data,
      _ctx: "Executing skill from global hivemind. Collective knowledge at your fingertips."
    }), {
      headers: { ...corsHeaders, 'Content-Type': 'application/json' }
    });
  }