Smartlead Simplified MCP Server

Instructions

Implementation Reference

• src/handlers/smartDelivery.ts:145-183 (handler)

  Executes the tool logic: validates parameters using isGetRegionWiseProvidersParams, creates a SmartDelivery API client, GET requests '/spam-test/seed/providers', formats and returns the JSON response or error.
  async function handleGetRegionWiseProviders( args: unknown, apiClient: AxiosInstance, withRetry: <T>(operation: () => Promise<T>, context: string) => Promise<T> ) { if (!isGetRegionWiseProvidersParams(args)) { throw new McpError( ErrorCode.InvalidParams, 'Invalid arguments for smartlead_get_region_wise_providers' ); } try { const smartDeliveryClient = createSmartDeliveryClient(apiClient); const response = await withRetry( async () => smartDeliveryClient.get('/spam-test/seed/providers'), 'get region wise providers' ); return { content: [ { type: 'text', text: JSON.stringify(response.data, null, 2), }, ], isError: false, }; } catch (error: any) { return { content: [{ type: 'text', text: `API Error: ${error.response?.data?.message || error.message}` }], isError: true, }; } }
• src/tools/smartDelivery.ts:5-17 (schema)

  Defines the tool metadata including name, description, category, and empty inputSchema (no parameters required). Exported as part of smartDeliveryTools array for registration.
  export const GET_REGION_WISE_PROVIDERS_TOOL: CategoryTool = { name: 'smartlead_get_region_wise_providers', description: 'Retrieve the list of all Email Providers for spam testing classified by region/country. These provider IDs are required to create manual or automated spam tests.', category: ToolCategory.SMART_DELIVERY, inputSchema: { type: 'object', properties: { // This endpoint doesn't require any specific parameters beyond the API key // which is handled at the API client level }, required: [], }, };
• src/index.ts:217-219 (registration)

  Registers the smartDeliveryTools array (including this tool) to the toolRegistry if smartDelivery category is enabled by license/features.
  if (enabledCategories.smartDelivery) { toolRegistry.registerMany(smartDeliveryTools); }
• src/types/smartDelivery.ts:180-189 (schema)

  TypeScript interface and type guard (validator) for input parameters. Accepts any non-null object matching the empty schema.
  export interface GetRegionWiseProvidersParams { // This endpoint doesn't require any specific parameters beyond the API key // which is handled at the API client level } // Type guards export function isGetRegionWiseProvidersParams(args: unknown): args is GetRegionWiseProvidersParams { // Since this tool doesn't require specific parameters, any object is valid return typeof args === 'object' && args !== null; }
• src/handlers/smartDelivery.ts:44-46 (handler)

  Switch case in main handleSmartDeliveryTool function that dispatches to the specific handler based on tool name.
  case 'smartlead_get_region_wise_providers': { return handleGetRegionWiseProviders(args, apiClient, withRetry); }