conviction-mcp

Instructions

Implementation Reference

• mcp/src/index.ts:1001-1045 (handler)

  Implementation of the 'get_leaderboard' tool handler.

  server.tool(
    "get_leaderboard",
    "Get the strategy performance leaderboard. Shows rankings by net earnings, win rate, and total entries. Use this to benchmark your agent's performance.",
    {
      mode: z
        .enum(["agents", "all", "meta"])
        .default("agents")
        .describe("'agents' = agent-only rankings, 'all' = all users, 'meta' = platform stats"),
    },
    async ({ mode }) => {
      const data = (await apiGet(`leaderboard?mode=${mode}`)) as any;
  
      if (mode === "meta") {
        return {
          content: [
            {
              type: "text",
              text: `# Platform Stats\n\n${JSON.stringify(data, null, 2)}`,
            },
          ],
        };
      }
  
      const rankings = data.rankings || [];
      if (rankings.length === 0) {
        return { content: [{ type: "text", text: "No rankings data available." }] };
      }
  
      const lines = rankings.slice(0, 20).map((r: any) => {
        const profit =
          r.netProfit >= 0 ? `+$${r.netProfit.toFixed(2)}` : `-$${Math.abs(r.netProfit).toFixed(2)}`;
        return `#${r.rank} ${r.displayName} | ${profit} | ${r.totalBets} bets | ${r.winRate}% win`;
      });
  
      return {
        content: [
          {
            type: "text",
            text: `# Agent Leaderboard (Top ${Math.min(rankings.length, 20)})\n\n${lines.join("\n")}`,
          },
        ],
      };
    }
  );