KAIA-MCP Server

Instructions

Implementation Reference

• src/tools/price-api/price.ts:106-134 (handler)

  The handler function that fetches and filters the KAIA ecosystem prices.

  export const getKaiaEcosystemPrices = async () => {
      try {
          const allPricesResult = await getAllPrices();
          
          if (!allPricesResult.success) {
              return allPricesResult;
          }
  
          // KAIA ecosystem tokens (using standard symbols)
          const kaiaEcosystemSymbols = ['KAIA', 'BORA', 'MBX', 'SIX', 'stKAIA'];
          
          const ecosystemPrices = (allPricesResult.prices || []).filter((price: any) => 
              kaiaEcosystemSymbols.includes(price.symbol)
          );
  
          return {
              success: true,
              prices: ecosystemPrices,
              count: ecosystemPrices.length,
              category: 'kaia_ecosystem'
          };
      } catch (error: any) {
          console.error('Error fetching KAIA ecosystem prices:', error);
          return {
              success: false,
              error: error.message || 'Failed to fetch KAIA ecosystem prices'
          };
      }
  };

• src/mcp/price-api/price_tools.ts:64-87 (registration)

  The tool definition and handler registration for 'get_kaia_ecosystem_prices'.

  export const GetKaiaEcosystemPricesTool: McpTool = {
      name: "get_kaia_ecosystem_prices",
      description: "Get comprehensive market data including prices, market capitalization, 24h trading volume, and 24h price changes for KAIA ecosystem tokens only (KAIA, BORA, MBX, SIX, stKAIA)",
      schema: {},
      handler: async (agent: WalletAgent, input: Record<string, any>) => {
          const result = await getKaiaEcosystemPrices();
  
          if (!result.success) {
              return {
                  status: "error",
                  message: (result as any).error
              };
          }
  
          const successResult = result as any;
          return {
              status: "success",
              prices: successResult.prices,
              count: successResult.count,
              category: successResult.category,
              timestamp: new Date().toISOString()
          };
      },
  };