Updated tool descriptions to be more descriptive

tools/anthropic/chat.ts

@@ -22,7 +22,8 @@ export interface ChatResponse extends ToolResponse {
 export const chatTool: ToolConfig<ChatParams, ChatResponse> = {
   id: 'anthropic_chat',
   name: 'Anthropic Chat',
-  description: 'Chat with Anthropic Claude models',
+  description:
+    "Interact with Anthropic's Claude models for advanced language understanding, reasoning, and generation tasks. Supports system prompts, context management, and configurable parameters for response generation.",
   version: '1.0.0',
 
   params: {

tools/crewai/vision.ts

@@ -18,7 +18,8 @@ export interface VisionResponse extends ToolResponse {
 export const visionTool: ToolConfig<VisionParams, VisionResponse> = {
   id: 'crewai_vision',
   name: 'Vision Analysis',
-  description: 'Analyze images using vision models',
+  description:
+    'Process and analyze images using advanced vision models. Capable of understanding image content, extracting text, identifying objects, and providing detailed visual descriptions.',
   version: '1.0.0',
 
   params: {

tools/deepseek/chat.ts

@@ -25,7 +25,8 @@ export interface ChatResponse extends ToolResponse {
 export const chatTool: ToolConfig<ChatParams, ChatResponse> = {
   id: 'deepseek_chat',
   name: 'DeepSeek Chat',
-  description: 'Chat with DeepSeek-v3 model',
+  description:
+    "Interact with DeepSeek's advanced language models optimized for code understanding and generation. Supports system prompts, context-aware responses, and configurable output formats.",
   version: '1.0.0',
 
   params: {

tools/deepseek/reasoner.ts

@@ -24,7 +24,8 @@ export interface ChatResponse extends ToolResponse {
 export const reasonerTool: ToolConfig<ChatParams, ChatResponse> = {
   id: 'deepseek_reasoner',
   name: 'DeepSeek Reasoner',
-  description: 'Chat with DeepSeek-R1 reasoning model',
+  description:
+    "Leverage DeepSeek's specialized reasoning model for complex problem-solving, logical analysis, and step-by-step deduction. Optimized for tasks requiring structured thinking and detailed explanations.",
   version: '1.0.0',
 
   params: {

tools/firecrawl/scrape.ts

@@ -34,7 +34,8 @@ export interface ScrapeResponse extends ToolResponse {
 export const scrapeTool: ToolConfig<ScrapeParams, ScrapeResponse> = {
   id: 'firecrawl_scrape',
   name: 'Firecrawl Website Scraper',
-  description: 'Extract clean content from any webpage in markdown format',
+  description:
+    'Extract structured content from web pages with comprehensive metadata support. Converts content to markdown or HTML while capturing SEO metadata, Open Graph tags, and page information.',
   version: '1.0.0',
 
   params: {

tools/function/execute.ts

@@ -15,7 +15,8 @@ export interface CodeExecutionOutput extends ToolResponse {
 export const functionExecuteTool: ToolConfig<CodeExecutionInput, CodeExecutionOutput> = {
   id: 'function_execute',
   name: 'Function Execute',
-  description: 'Execute code in a sandboxed environment',
+  description:
+    'Execute code snippets in a secure, sandboxed environment with support for multiple languages. Captures both function output and stdout with proper error handling.',
   version: '1.0.0',
 
   params: {

tools/github/repo.ts

@@ -20,7 +20,8 @@ export interface RepoInfoResponse extends ToolResponse {
 export const repoInfoTool: ToolConfig<RepoInfoParams, RepoInfoResponse> = {
   id: 'github_repoinfo',
   name: 'GitHub Repository Info',
-  description: 'Fetch detailed information about a GitHub repository',
+  description:
+    'Retrieve comprehensive GitHub repository metadata including stars, forks, issues, and primary language. Supports both public and private repositories with optional authentication.',
   version: '1.0.0',
 
   params: {

tools/google/chat.ts

@@ -23,7 +23,8 @@ export interface ChatResponse extends ToolResponse {
 export const chatTool: ToolConfig<ChatParams, ChatResponse> = {
   id: 'google_chat',
   name: 'Google Chat',
-  description: 'Chat with Google Gemini models',
+  description:
+    "Interact with Google's Gemini models for advanced language tasks with built-in safety ratings. Supports system prompts, context management, and fine-tuned generation parameters including top-k and top-p sampling.",
   version: '1.0.0',
 
   params: {

tools/http/request.ts

@@ -23,7 +23,8 @@ export interface RequestResponse extends ToolResponse {
 export const requestTool: ToolConfig<RequestParams, RequestResponse> = {
   id: 'http_request',
   name: 'HTTP Request',
-  description: 'Make HTTP requests to any endpoint with support for CRUD operations',
+  description:
+    'Make HTTP requests with comprehensive support for methods, headers, query parameters, path parameters, and form data. Features configurable timeout and status validation for robust API interactions.',
   version: '1.0.0',
 
   params: {

tools/hubspot/contacts.ts

@@ -29,7 +29,8 @@ export interface ContactsResponse extends ToolResponse {
 export const contactsTool: ToolConfig<ContactsParams, ContactsResponse> = {
   id: 'hubspot_contacts',
   name: 'HubSpot Contacts',
-  description: 'Manage HubSpot contacts - create, search, and update contact records',
+  description:
+    'Manage HubSpot CRM contacts with full CRUD operations support. Handle contact properties, pagination, and custom fields while maintaining data consistency across the CRM.',
   version: '1.0.0',
 
   params: {

tools/index.ts

@@ -18,7 +18,35 @@ import { searchTool as tavilySearch } from './tavily/search'
 import { ToolConfig, ToolResponse } from './types'
 import { chatTool as xaiChat } from './xai/chat'
 
-// Registry of all available tools
+/**
+ * Registry of all available tools. Each tool is designed for specific use cases:
+ *
+ * AI Model Tools:
+ * - openai_chat: Advanced language model for general conversation, reasoning, and task completion
+ * - anthropic_chat: Claude model specialized in detailed analysis and complex reasoning
+ * - google_chat: PaLM model for general conversation and task assistance
+ * - xai_chat: Specialized AI model for explainable AI interactions
+ * - deepseek_chat: Code-specialized language model for programming tasks
+ * - deepseek_reasoner: Advanced reasoning model for complex problem-solving
+ *
+ * Web & Data Tools:
+ * - http_request: Make HTTP requests to any API endpoint with custom headers and body
+ * - firecrawl_scrape: Extract structured data from web pages with advanced scraping
+ * - jina_readurl: Efficiently read and parse content from web URLs
+ * - serper_search: Perform web searches with high-quality, structured results
+ * - tavily_search: AI-powered web search with comprehensive results
+ * - tavily_extract: Extract specific information from web content
+ *
+ * Business Integration Tools:
+ * - hubspot_contacts: Manage and query HubSpot CRM contacts
+ * - salesforce_opportunities: Handle Salesforce sales opportunities
+ * - slack_message: Send messages to Slack channels or users
+ * - github_repoinfo: Fetch detailed information about GitHub repositories
+ *
+ * Utility Tools:
+ * - function_execute: Execute custom JavaScript functions with provided parameters
+ * - crewai_vision: Process and analyze images with AI capabilities
+ */
 export const tools: Record<string, ToolConfig> = {
   // AI Models
   openai_chat: openAIChat,

tools/jina/reader.ts

@@ -17,7 +17,8 @@ export interface ReadUrlResponse extends ToolResponse {
 export const readUrlTool: ToolConfig<ReadUrlParams, ReadUrlResponse> = {
   id: 'jina_readurl',
   name: 'Jina Reader',
-  description: 'Convert any URL to LLM-friendly text using Jina AI Reader',
+  description:
+    'Extract and process web content into clean, LLM-friendly text using Jina AI Reader. Supports advanced content parsing, link gathering, and multiple output formats with configurable processing options.',
   version: '1.0.0',
 
   params: {

tools/openai/chat.ts

@@ -26,7 +26,8 @@ export interface ChatResponse extends ToolResponse {
 export const chatTool: ToolConfig<ChatParams, ChatResponse> = {
   id: 'openai_chat',
   name: 'OpenAI Chat',
-  description: 'Chat with OpenAI models',
+  description:
+    "Interact with OpenAI's GPT models for natural language processing and generation. Supports system prompts, context management, and fine-tuned response parameters including temperature and token control.",
   version: '1.0.0',
 
   params: {

tools/salesforce/opportunities.ts

@@ -30,7 +30,8 @@ export interface OpportunityResponse extends ToolResponse {
 export const opportunitiesTool: ToolConfig<OpportunityParams, OpportunityResponse> = {
   id: 'salesforce_opportunities',
   name: 'Salesforce Opportunities',
-  description: 'Manage Salesforce opportunities - create, query, and update opportunity records',
+  description:
+    'Manage Salesforce sales opportunities with comprehensive CRUD operations. Track stages, amounts, probabilities, and related account data with support for custom fields and paginated results.',
   version: '1.0.0',
 
   params: {

tools/serper/search.ts

@@ -30,7 +30,8 @@ export interface SearchResponse extends ToolResponse {
 export const searchTool: ToolConfig<SearchParams, SearchResponse> = {
   id: 'serper_search',
   name: 'Web Search',
-  description: 'Search the web using Serper.dev API',
+  description:
+    'A powerful web search tool that provides access to Google search results through Serper.dev API. Supports different types of searches including regular web search, news, places, and images, with each result containing relevant metadata like titles, URLs, snippets, and type-specific information.',
   version: '1.0.0',
 
   params: {

tools/slack/message.ts

@@ -16,7 +16,8 @@ export interface SlackMessageResponse extends ToolResponse {
 export const slackMessageTool: ToolConfig<SlackMessageParams, SlackMessageResponse> = {
   id: 'slack_message',
   name: 'Slack Message',
-  description: 'Send a message to a Slack channel',
+  description:
+    'Send messages to Slack channels or users through the Slack API. Enables direct communication and notifications with timestamp tracking and channel confirmation.',
   version: '1.0.0',
 
   params: {

tools/tavily/extract.ts

@@ -25,7 +25,8 @@ export interface ExtractResponse extends ToolResponse {
 export const extractTool: ToolConfig<ExtractParams, ExtractResponse> = {
   id: 'tavily_extract',
   name: 'Tavily Extract',
-  description: 'Extract web page content from URLs using Tavily Extract',
+  description:
+    "Extract raw content from multiple web pages simultaneously using Tavily's extraction API. Supports basic and advanced extraction depths with detailed error reporting for failed URLs.",
   version: '1.0.0',
 
   params: {

tools/tavily/search.ts

@@ -24,7 +24,8 @@ export interface SearchResponse extends ToolResponse {
 export const searchTool: ToolConfig<SearchParams, SearchResponse> = {
   id: 'tavily_search',
   name: 'Tavily Search',
-  description: 'Search the web using Tavily AI Search API',
+  description:
+    "Perform AI-powered web searches using Tavily's search API. Returns structured results with titles, URLs, snippets, and optional raw content, optimized for relevance and accuracy.",
   version: '1.0.0',
 
   params: {

tools/xai/chat.ts

@@ -24,7 +24,8 @@ export interface ChatResponse extends ToolResponse {
 export const chatTool: ToolConfig<ChatParams, ChatResponse> = {
   id: 'xai_chat',
   name: 'xAI Chat',
-  description: 'Chat with xAI models',
+  description:
+    "Interact with xAI's Grok models featuring advanced reasoning capabilities. Supports system prompts, context management, and provides detailed reasoning paths alongside responses.",
   version: '1.0.0',
 
   params: {