Hive Intelligence

Instructions

Implementation Reference

• src/dynamic-tools.ts:166-179 (handler)

  The core handler function for the 'get_nft_analytics_endpoints' tool. It calls getAllToolsInCategory('NFT Analytics') to retrieve the list of tools in this category from supportedTools, formats the response with category info and tool names/descriptions, and uses asTextContentResult to handle output formatting and truncation.

      args: Record<string, unknown> | undefined,
    ): Promise<any> => {
      const toolsInCategory = getAllToolsInCategory(category.category);
      
      return asTextContentResult({
        category: category.category,
        description: category.description,
        tools: toolsInCategory.map((tool ) => ({
          name: tool.name,
          description: tool.description
        })),
      });
    },
  };

• src/dynamic-tools.ts:148-182 (registration)

  Dynamic registration of category endpoint tools, including 'get_nft_analytics_endpoints'. Maps over ToolRegistry to create a tool for each category with name from category.name, empty input schema, and the shared handler logic.

  // Create category-specific endpoints that act as list functionality
  const categoryTools = ToolRegistry.map(category => {
    const categorySchema = z.object({});
    
    const categoryEndpointName = category.name;
    
    return {
      metadata: {
        resource: 'dynamic_tools',
        operation: 'read' as const,
        tags: ['category'],
      },
      tool: {
        name: categoryEndpointName,
        description: `Get all endpoints in the "${category.category}" category. ${category.description}`,
        inputSchema: zodToInputSchema(categorySchema),
      },
      handler: async (
        args: Record<string, unknown> | undefined,
      ): Promise<any> => {
        const toolsInCategory = getAllToolsInCategory(category.category);
        
        return asTextContentResult({
          category: category.category,
          description: category.description,
          tools: toolsInCategory.map((tool ) => ({
            name: tool.name,
            description: tool.description
          })),
        });
      },
    };
  });
  
  return [getEndpointTool, callEndpointTool, ...categoryTools];

• src/dynamic-tools.ts:150-151 (schema)

  Input schema for category endpoint tools (empty object since no parameters are required). Converted to JSON schema via zodToInputSchema.

  const categorySchema = z.object({});

• src/toolRegistry.ts:183-219 (registration)

  Source metadata for the NFT Analytics category used to dynamically create the 'get_nft_analytics_endpoints' tool name, description, and list of underlying tool names to match against supportedTools.

  {
    "category": "NFT Analytics",
    "name": "get_nft_analytics_endpoints",
    "description": "Endpoints for comprehensive NFT ecosystem analysis including collection data, market analytics, user NFT holdings, collection floor prices, trading volumes, historical NFT market data, NFT liquidity pools and AMM marketplaces (like Sudoswap), NFT DeFi analytics, Prime ecosystem pools, Parallel trading card game assets, NFT pool management, collection holder analysis, advanced NFT search and filtering, contract metadata, cross-chain NFT analytics, social sentiment tracking for NFT collections, and time series market trend analysis.",
    "tools": [
      "id_nfts_browser",
      "list_nfts_browser",
      "nfts_market_chart_browser",
      "get_nft_list", 
      "get_all_nft",
      "get_nft_collection",
      "nft_pool_details",
      "nft_pool_events_data",
      "nft_collection_pool_stats",
      "exchange_nft_collections",
      "collection_exchange_pools",
      "owner_nft_pools",
      "nft_collections_search",
      "nft_pool_collections_search",
      "nfts_search_advanced",
      "nft_pools_search",
      "nft_collection_assets",
      "nft_collection_detailed_stats",
      "nft_collection_events",
      "nft_contracts_metadata",
      "parallel_assets_search",
      "parallel_card_changes",
      "prime_pool_assets_data",
      "prime_pool_events_data",
      "prime_pools_info",
      "nft_collection_holders",
      "prime_token_holders",
      "explore_nft_collections",
      "analyze_nft_collection",
      "track_nft_market_trends"
    ]
  },

• src/toolRegistry.ts:298-314 (helper)

  Helper function called by the handler to resolve the list of actual tool objects from supportedTools by matching names in the NFT category's 'tools' array.

  export function getAllToolsInCategory(category: string){
    let categoryUsed = ToolRegistry.find(tool => tool.category === category);
    if(!categoryUsed){
      return []
    }
    const allWrappedTools = supportedTools
    // return all the tools from wrapped tools that are in the category (name match)
    let toolsInCategory = [];
    for (const tool of categoryUsed.tools){
      const wrappedTool = allWrappedTools.find(wrappedTool => wrappedTool.name === tool);
      if(wrappedTool){
        toolsInCategory.push(wrappedTool);
      }
      else console.log(`Tool ${tool} not found in wrapped tools`);
    }
    return toolsInCategory;
  }