x402 MCP Server

Instructions

Implementation Reference

• src/index.ts:399-425 (handler)

  The handler implementation for the 'x402_market_overview' MCP tool, which fetches market sentiment data from either a paid or free endpoint based on the presence of a private key.

  server.tool(
    "x402_market_overview",
    `Get a broad crypto market sentiment overview covering major coins and trends.
  Price: $0.05 USDC per query.
  
  Provides aggregate sentiment across the crypto market.
  Without X402_PRIVATE_KEY, only the free test endpoint is available.
  
  Returns: market-wide sentiment data, top movers, and trend analysis.`,
    {},
    async () => {
      const base = APIS.sentiment.baseUrl;
  
      try {
        const usePaid = !!PRIVATE_KEY;
        const endpoint = usePaid ? "/market/overview" : "/test/market/overview";
  
        const data = await apiGet(base, endpoint, usePaid);
        return textResult({
          mode: usePaid ? "paid" : "free_test",
          cost: usePaid ? "$0.05" : "free",
          ...data,
        });
      } catch (err: any) {
        return errorResult(err.message);
      }
    }