Twining MCP Server

Instructions

Implementation Reference

• src/tools/coordination-tools.ts:133-168 (handler)

  The handler and registration for 'twining_discover' tool. It calls coordinationEngine.discover to find agents.

  // twining_discover — Find agents matching required capabilities
  server.registerTool(
    "twining_discover",
    {
      description:
        "Find agents matching required capabilities, ranked by capability overlap and liveness. Returns scored agent list for delegation decisions.",
      inputSchema: {
        required_capabilities: z
          .array(z.string())
          .describe("Capabilities the agent must have (e.g. ['testing', 'typescript'])"),
        include_gone: z
          .boolean()
          .optional()
          .describe("Whether to include gone agents (default: true)"),
        min_score: z
          .number()
          .optional()
          .describe("Minimum total_score threshold (default: 0)"),
      },
    },
    async (args) => {
      try {
        const result = await coordinationEngine.discover({
          required_capabilities: args.required_capabilities,
          include_gone: args.include_gone,
          min_score: args.min_score,
        });
        return toolResult(result);
      } catch (e) {
        return toolError(
          e instanceof Error ? e.message : "Unknown error",
          "INTERNAL_ERROR",
        );
      }
    },
  );