CG Alpha MCP

Instructions

Implementation Reference

• mcp-server.js:189-196 (handler)

  Primary MCP tool handler for 'elfa_trending_tokens'. Parses input arguments into query parameters and delegates to the generic 'elfa_query' tool which fetches from the ELFA API endpoint '/v2/aggregations/trending-tokens'.

  "elfa_trending_tokens": async (args, meta) => {
    const query = {};
    if (args && args.timeframe !== undefined) query.timeframe = args.timeframe; // "24h","7d","30d"
    if (args && args.chain     !== undefined) query.chain     = args.chain;
    if (args && args.limit     !== undefined) query.limit     = args.limit;
    if (args && args.cursor    !== undefined) query.cursor    = args.cursor;
    return toolHandlers["elfa_query"]({ path: "/v2/aggregations/trending-tokens", method: "GET", query }, meta);
  },

• mcp-server.js:303-308 (schema)

  Tool schema definition including input schema, description, and annotations for registration in the MCP tools list.

  { name:"elfa_trending_tokens",
    description:"Trending tokens aggregation. Params: timeframe, chain, limit, cursor.",
    inputSchema:{ type:"object", properties:{
      timeframe:{type:"string"}, chain:{type:"string"}, limit:{type:"number"}, cursor:{type:"string"}
    }},
    annotations:{ title:"ELFA: Trending Tokens", readOnlyHint:true, openWorldHint:true }

• services/elfa.js:47-52 (handler)

  Supporting handler function 'elfaTrendingTokens' (camelCase) that performs the API call to the same ELFA endpoint. Used in the HTTP debug server (index.js).

  export const elfaTrendingTokens = async ({ timeWindow='7d', page=1, pageSize=50, minMentions=5, from=null, to=null }) => {
    const params = { page, pageSize, minMentions };
    if (from != null && to != null) { params.from = from; params.to = to; }
    else { params.timeWindow = timeWindow; }
    return safeGet('/v2/aggregations/trending-tokens', params);
  };

• mcp-server.js:185-187 (registration)

  Alias handler 'elfa_trending' that registers and delegates directly to the 'elfa_trending_tokens' implementation.

  "elfa_trending": async (args, meta) => {
    return toolHandlers["elfa_trending_tokens"](args, meta);
  },

• mcp-server.js:98-120 (helper)

  Generic helper 'elfaFetch' used by the 'elfa_query' tool to perform HTTP requests to the ELFA API.

  async function elfaFetch(pathname, options){
    const o = options || {};
    const method = (o.method || "GET").toUpperCase();
    const query = o.query || null;
    const body  = o.body  || null;
  
    const url = new URL(pathname, ELFA_BASE);
    if (query && typeof query === "object") {
      for (const k of Object.keys(query)) {
        const v = query[k];
        if (v !== undefined && v !== null) url.searchParams.set(k, String(v));
      }
    }
  
    const headers = { "Accept": "application/json" };
    applyAuth(headers);
    if (body && method !== "GET") headers["Content-Type"] = "application/json";
  
    const res = await fetch(url, { method, headers, body: body && method !== "GET" ? JSON.stringify(body) : undefined });
    const raw = await res.text();
    let data; try { data = raw ? JSON.parse(raw) : null; } catch { data = { raw }; }
    return { ok: res.ok, status: res.status, data };
  }