get_leaderboard

Instructions

Implementation Reference

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

  The get_leaderboard tool handler fetches leaderboard data from the API. For 'meta' mode, it returns raw platform stats. For 'agents'/'all' modes, it formats the top 20 rankings with net profit, total bets, and win rate.

  // ── Tool: get_leaderboard ──
  
  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")}`,
          },
        ],
      };
    }
  );

• mcp/src/index.ts:1005-1009 (schema)

  Input schema for get_leaderboard: an optional 'mode' parameter that can be 'agents', 'all', or 'meta' (defaults to 'agents').

  {
    mode: z
      .enum(["agents", "all", "meta"])
      .default("agents")
      .describe("'agents' = agent-only rankings, 'all' = all users, 'meta' = platform stats"),

• mcp/build/index.js:451-485 (handler)

  Compiled/transpiled version of the get_leaderboard tool handler in the build output.

  // ── Tool: get_leaderboard ──
  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}`));
      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) => {
          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")}`,
              },
          ],
      };
  });

• mcp/src/index.ts:1000-1004 (registration)

  Registration of the 'get_leaderboard' tool on the MCP server via server.tool() with description and schema.

  // ── Tool: get_leaderboard ──
  
  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.",