SkillFlow MCP Server

Instructions

Implementation Reference

• src/index.ts:251-290 (handler)

  The handler logic for the 'search_skills' tool, which filters the 'SKILL_CATALOG' based on query, category, and trust score.

  case "search_skills": {
    const query = (args?.query as string || "").toLowerCase();
    const category = (args?.category as string || "").toLowerCase();
    const minScore = (args?.min_trust_score as number) || 0;
  
    const results = SKILL_CATALOG.filter((skill) => {
      const matchesQuery =
        skill.name.toLowerCase().includes(query) ||
        skill.description.toLowerCase().includes(query) ||
        skill.tags.some((t) => t.includes(query));
      const matchesCategory = !category || skill.category.toLowerCase() === category;
      const matchesScore = skill.trust_score >= minScore;
      return matchesQuery && matchesCategory && matchesScore;
    });
  
    if (results.length === 0) {
      return {
        content: [{
          type: "text",
          text: `No skills found for "${args?.query}". Try browsing categories with list_categories or check trending skills with get_trending_skills.\n\nBrowse all skills at: ${SKILLFLOW_BASE_URL}/explore`,
        }],
      };
    }
  
    const formatted = results.map((s) =>
      `**${s.name}** (Trust: ${s.trust_score}/100)\n` +
      `  ${s.description}\n` +
      `  Category: ${s.category} | Publisher: ${s.publisher}\n` +
      `  Platforms: ${s.platforms.join(", ")}\n` +
      `  Install: \`${s.install}\`\n` +
      `  URL: ${s.url}`
    ).join("\n\n");
  
    return {
      content: [{
        type: "text",
        text: `Found ${results.length} skill(s) matching "${args?.query}":\n\n${formatted}\n\n---\nBrowse more at: ${SKILLFLOW_BASE_URL}/explore`,
      }],
    };
  }

• src/index.ts:190-202 (registration)

  Registration of the 'search_skills' tool, including its schema and description.

  {
    name: "search_skills",
    description: "Search for AI agent skills on SkillFlow marketplace by keyword, category, or tag. Returns matching skills with trust scores and install instructions.",
    inputSchema: {
      type: "object" as const,
      properties: {
        query: { type: "string", description: "Search query (keyword, category name, or tag)" },
        category: { type: "string", description: "Filter by category (e.g., 'Development', 'Productivity', 'DevOps')" },
        min_trust_score: { type: "number", description: "Minimum trust score (0-100)", default: 0 },
      },
      required: ["query"],
    },
  },