madeonsol_alpha_leaderboard

Instructions

Implementation Reference

• src/index.ts:582-600 (registration)

  Tool registered with server.tool() under the name 'madeonsol_alpha_leaderboard', within the auth-restricted block (requires MADEONSOL_API_KEY).

  server.tool(
    "madeonsol_alpha_leaderboard",
    "Top statistically profitable early-buyer wallets, scored from 47,000+ early-buyer records. BASIC=25 (truncated), PRO=100, ULTRA=500 + bot signals.",
    {
      period: z.enum(["7d", "30d", "all"]).default("30d").describe("Time window"),
      min_tokens: z.number().min(1).max(20).default(5).describe("Minimum tokens traded by wallet (1-20)"),
      sort: z.enum(["win_rate", "pnl", "roi"]).default("win_rate").describe("Sort axis"),
      exclude_bots: z.boolean().default(true).describe("Exclude wallets flagged as bots"),
    },
    { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
    async ({ period, min_tokens, sort, exclude_bots }) => {
      const params: Record<string, string | number> = { period, min_tokens, sort, exclude_bots: exclude_bots ? "true" : "false" };
      const url = new URL(`${BASE_URL}/api/v1/alpha/leaderboard`);
      for (const [k, v] of Object.entries(params)) url.searchParams.set(k, String(v));
      const res = await fetch(url.toString(), { headers: { "Content-Type": "application/json", ...apiKeyHeaders() } });
      const text = res.ok ? JSON.stringify(await res.json(), null, 2) : `Error ${res.status}: ${await res.text().catch(() => "")}`;
      return { content: [{ type: "text" as const, text }] };
    }
  );

• src/index.ts:585-591 (schema)

  Input schema: period (7d/30d/all, default 30d), min_tokens (1-20, default 5), sort (win_rate/pnl/roi, default win_rate), exclude_bots (boolean, default true).

  {
    period: z.enum(["7d", "30d", "all"]).default("30d").describe("Time window"),
    min_tokens: z.number().min(1).max(20).default(5).describe("Minimum tokens traded by wallet (1-20)"),
    sort: z.enum(["win_rate", "pnl", "roi"]).default("win_rate").describe("Sort axis"),
    exclude_bots: z.boolean().default(true).describe("Exclude wallets flagged as bots"),
  },
  { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },

• src/index.ts:592-599 (handler)

  Handler function: builds query params, fetches GET /api/v1/alpha/leaderboard with API key auth, returns JSON response.

  async ({ period, min_tokens, sort, exclude_bots }) => {
    const params: Record<string, string | number> = { period, min_tokens, sort, exclude_bots: exclude_bots ? "true" : "false" };
    const url = new URL(`${BASE_URL}/api/v1/alpha/leaderboard`);
    for (const [k, v] of Object.entries(params)) url.searchParams.set(k, String(v));
    const res = await fetch(url.toString(), { headers: { "Content-Type": "application/json", ...apiKeyHeaders() } });
    const text = res.ok ? JSON.stringify(await res.json(), null, 2) : `Error ${res.status}: ${await res.text().catch(() => "")}`;
    return { content: [{ type: "text" as const, text }] };
  }

• dist/index.js:427-440 (registration)

  Compiled JS registration of the tool with identical schema and handler logic.

  server.tool("madeonsol_alpha_leaderboard", "Top statistically profitable early-buyer wallets, scored from 47,000+ early-buyer records. BASIC=25 (truncated), PRO=100, ULTRA=500 + bot signals.", {
      period: z.enum(["7d", "30d", "all"]).default("30d").describe("Time window"),
      min_tokens: z.number().min(1).max(20).default(5).describe("Minimum tokens traded by wallet (1-20)"),
      sort: z.enum(["win_rate", "pnl", "roi"]).default("win_rate").describe("Sort axis"),
      exclude_bots: z.boolean().default(true).describe("Exclude wallets flagged as bots"),
  }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ period, min_tokens, sort, exclude_bots }) => {
      const params = { period, min_tokens, sort, exclude_bots: exclude_bots ? "true" : "false" };
      const url = new URL(`${BASE_URL}/api/v1/alpha/leaderboard`);
      for (const [k, v] of Object.entries(params))
          url.searchParams.set(k, String(v));
      const res = await fetch(url.toString(), { headers: { "Content-Type": "application/json", ...apiKeyHeaders() } });
      const text = res.ok ? JSON.stringify(await res.json(), null, 2) : `Error ${res.status}: ${await res.text().catch(() => "")}`;
      return { content: [{ type: "text", text }] };
  });

• dist/index.js:712-712 (registration)

  Tool listed in the Smithery server card (tools array) for HTTP discovery.

  { name: "madeonsol_alpha_leaderboard", description: "Top profitable early-buyer wallets — 47,000+ scored. BASIC=25, PRO=100, ULTRA=500." },