Smartlead Simplified MCP Server

Instructions

Implementation Reference

• src/index.ts:360-361 (handler)

  Entry point for executing smartlead_search_domain and other SMART_SENDERS category tools; dispatches to specific handleSmartSendersTool function.

  case ToolCategory.SMART_SENDERS:
    return await handleSmartSendersTool(name, toolArgs, apiClient, withRetry);

• src/tools/smartSenders.ts:19-37 (schema)

  Primary schema definition for the smartlead_search_domain tool, including name, description, category, and detailed input schema.

  export const SEARCH_DOMAIN_TOOL: CategoryTool = {
    name: 'smartlead_search_domain',
    description: 'Search for available domains under $15 that match a given domain name pattern.',
    category: ToolCategory.SMART_SENDERS,
    inputSchema: {
      type: 'object',
      properties: {
        domain_name: {
          type: 'string',
          description: 'The domain name pattern you want to search for',
        },
        vendor_id: {
          type: 'integer',
          description: 'ID of the vendor from whom you want to purchase the domain (use Get Vendors API to retrieve this ID)',
        },
      },
      required: ['domain_name', 'vendor_id'],
    },
  };

• src/index.ts:233-234 (registration)

  Registers the array of SmartSenders tools (including smartlead_search_domain) to the tool registry if the feature is enabled.

    toolRegistry.registerMany(smartSendersTools);
  }

• src/types/smartSenders.ts:10-13 (schema)

  TypeScript interface defining the expected input parameters for the smartlead_search_domain tool.

  export interface SearchDomainParams {
    domain_name: string;
    vendor_id: number;
  }

• src/types/smartSenders.ts:55-64 (helper)

  Type guard helper function for validating input arguments match SearchDomainParams for the smartlead_search_domain tool.

  export function isSearchDomainParams(args: unknown): args is SearchDomainParams {
    if (typeof args !== 'object' || args === null) return false;
    
    const params = args as Partial<SearchDomainParams>;
    
    return (
      typeof params.domain_name === 'string' &&
      typeof params.vendor_id === 'number'
    );
  }