Smartlead Simplified MCP Server

Instructions

Implementation Reference

• src/handlers/smartDelivery.ts:674-712 (handler)

  The core handler function that validates input using isRdnsDetailsParams, creates a SmartDelivery API client, fetches rDNS details from `/spam-test/report/${spam_test_id}/rdns-details`, and returns the JSON response or formatted error.
  async function handleGetRdnsDetails( args: unknown, apiClient: AxiosInstance, withRetry: <T>(operation: () => Promise<T>, context: string) => Promise<T> ) { if (!isRdnsDetailsParams(args)) { throw new McpError( ErrorCode.InvalidParams, 'Invalid arguments for smartlead_get_rdns_details' ); } try { const smartDeliveryClient = createSmartDeliveryClient(apiClient); const { spam_test_id } = args; const response = await withRetry( async () => smartDeliveryClient.get(`/spam-test/report/${spam_test_id}/rdns-details`), 'get rDNS details' ); 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:344-358 (schema)

  Tool definition including name, description, category, and input schema requiring 'spam_test_id' as integer. This object is exported and included in smartDeliveryTools array for registration.
  export const GET_RDNS_DETAILS_TOOL: CategoryTool = { name: 'smartlead_get_rdns_details', description: 'Check if rDNS was correct for an IP sending the email.', category: ToolCategory.SMART_DELIVERY, inputSchema: { type: 'object', properties: { spam_test_id: { type: 'integer', description: 'ID of the spam test to get the rDNS details for', }, }, required: ['spam_test_id'], }, };
• src/types/smartDelivery.ts:104-324 (schema)

  TypeScript interface and type guard function for validating tool input parameters, ensuring 'spam_test_id' is a number.
  // rDNS report types export interface RdnsDetailsParams { spam_test_id: number; } // Sender Account list types export interface SenderAccountsParams { spam_test_id: number; } // Blacklists types export interface BlacklistParams { spam_test_id: number; } // Spam test email content types export interface EmailContentParams { spam_test_id: number; } // Spam test IP blacklist count types export interface IpAnalyticsParams { spam_test_id: number; } // Email reply headers types export interface EmailHeadersParams { spam_test_id: number; reply_id: number; } // Schedule history for automated tests types export interface ScheduleHistoryParams { spam_test_id: number; } // IP details types export interface IpDetailsParams { spam_test_id: number; reply_id: number; } // Mailbox summary types export interface MailboxSummaryParams { limit?: number; offset?: number; } // Mailbox count API types export interface MailboxCountParams { // This endpoint doesn't require any specific parameters } // Get all folders types export interface GetAllFoldersParams { limit?: number; offset?: number; name?: string; } // Create folders types export interface CreateFolderParams { name: string; } // Get folder by ID types export interface GetFolderByIdParams { folder_id: number; } // Delete folder types export interface DeleteFolderParams { folder_id: number; } // Tool parameter interfaces 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; } export function isCreateManualPlacementTestParams(args: unknown): args is CreateManualPlacementTestParams { if (typeof args !== 'object' || args === null) return false; const params = args as Partial<CreateManualPlacementTestParams>; return ( typeof params.test_name === 'string' && Array.isArray(params.spam_filters) && typeof params.link_checker === 'boolean' && typeof params.campaign_id === 'number' && typeof params.sequence_mapping_id === 'number' && Array.isArray(params.provider_ids) && Array.isArray(params.sender_accounts) && typeof params.all_email_sent_without_time_gap === 'boolean' && typeof params.min_time_btwn_emails === 'number' && typeof params.min_time_unit === 'string' && typeof params.is_warmup === 'boolean' ); } export function isCreateAutomatedPlacementTestParams(args: unknown): args is CreateAutomatedPlacementTestParams { if (!isCreateManualPlacementTestParams(args)) return false; const params = args as Partial<CreateAutomatedPlacementTestParams>; return ( typeof params.schedule_start_time === 'string' && typeof params.test_end_date === 'string' && typeof params.every_days === 'number' && typeof params.tz === 'string' && Array.isArray(params.days) ); } export function isGetSpamTestDetailsParams(args: unknown): args is GetSpamTestDetailsParams { return ( typeof args === 'object' && args !== null && 'spam_test_id' in args && typeof (args as GetSpamTestDetailsParams).spam_test_id === 'number' ); } export function isDeleteSmartDeliveryTestsParams(args: unknown): args is DeleteSmartDeliveryTestsParams { return ( typeof args === 'object' && args !== null && 'spamTestIds' in args && Array.isArray((args as DeleteSmartDeliveryTestsParams).spamTestIds) && (args as DeleteSmartDeliveryTestsParams).spamTestIds.every(id => typeof id === 'number') ); } export function isStopAutomatedTestParams(args: unknown): args is StopAutomatedTestParams { return ( typeof args === 'object' && args !== null && 'spam_test_id' in args && typeof (args as StopAutomatedTestParams).spam_test_id === 'number' ); } export function isListAllTestsParams(args: unknown): args is ListAllTestsParams { if (typeof args !== 'object' || args === null) return false; const params = args as Partial<ListAllTestsParams>; return ( params.testType === 'manual' || params.testType === 'auto' ); } export function isProviderWiseReportParams(args: unknown): args is ProviderWiseReportParams { return ( typeof args === 'object' && args !== null && 'spam_test_id' in args && typeof (args as ProviderWiseReportParams).spam_test_id === 'number' ); } export function isGroupWiseReportParams(args: unknown): args is GroupWiseReportParams { return ( typeof args === 'object' && args !== null && 'spam_test_id' in args && typeof (args as GroupWiseReportParams).spam_test_id === 'number' ); } export function isSenderAccountWiseReportParams(args: unknown): args is SenderAccountWiseReportParams { return ( typeof args === 'object' && args !== null && 'spam_test_id' in args && typeof (args as SenderAccountWiseReportParams).spam_test_id === 'number' ); } export function isSpamFilterDetailsParams(args: unknown): args is SpamFilterDetailsParams { return ( typeof args === 'object' && args !== null && 'spam_test_id' in args && typeof (args as SpamFilterDetailsParams).spam_test_id === 'number' ); } export function isDkimDetailsParams(args: unknown): args is DkimDetailsParams { return ( typeof args === 'object' && args !== null && 'spam_test_id' in args && typeof (args as DkimDetailsParams).spam_test_id === 'number' ); } export function isSpfDetailsParams(args: unknown): args is SpfDetailsParams { return ( typeof args === 'object' && args !== null && 'spam_test_id' in args && typeof (args as SpfDetailsParams).spam_test_id === 'number' ); } export function isRdnsDetailsParams(args: unknown): args is RdnsDetailsParams { return ( typeof args === 'object' && args !== null && 'spam_test_id' in args && typeof (args as RdnsDetailsParams).spam_test_id === 'number' ); }
• src/handlers/smartDelivery.ts:83-85 (registration)

  Switch case in handleSmartDeliveryTool that dispatches the tool call to the specific handler function.
  case 'smartlead_get_rdns_details': { return handleGetRdnsDetails(args, apiClient, withRetry); }
• src/tools/smartDelivery.ts:595-595 (registration)

  Inclusion of the tool in the exported smartDeliveryTools array, likely used for MCP tool registration.
  GET_RDNS_DETAILS_TOOL,