Smartlead Simplified MCP Server

Instructions

Implementation Reference

• src/handlers/smartDelivery.ts:879-918 (handler)

  The handler function that performs input validation and makes the API call to retrieve email headers for the specified spam test and reply ID.

  async function handleGetEmailHeaders(
    args: unknown, 
    apiClient: AxiosInstance,
    withRetry: <T>(operation: () => Promise<T>, context: string) => Promise<T>
  ) {
    if (!isEmailHeadersParams(args)) {
      throw new McpError(
        ErrorCode.InvalidParams,
        'Invalid arguments for smartlead_get_email_headers'
      );
    }
  
    try {
      const smartDeliveryClient = createSmartDeliveryClient(apiClient);
      const { spam_test_id, reply_id } = args;
      
      const response = await withRetry(
        async () => smartDeliveryClient.get(`/spam-test/report/${spam_test_id}/sender-account-wise/${reply_id}/email-headers`),
        'get email headers'
      );
  
      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:424-442 (schema)

  Schema definition for the tool, specifying input parameters spam_test_id and reply_id.

  export const GET_EMAIL_HEADERS_TOOL: CategoryTool = {
    name: 'smartlead_get_email_headers',
    description: 'Get details of the email headers for a specific email.',
    category: ToolCategory.SMART_DELIVERY,
    inputSchema: {
      type: 'object',
      properties: {
        spam_test_id: {
          type: 'integer',
          description: 'ID of the spam test',
        },
        reply_id: {
          type: 'integer',
          description: 'ID of the email received by the seed account',
        },
      },
      required: ['spam_test_id', 'reply_id'],
    },
  };

• src/index.ts:216-219 (registration)

  Registration of all smartDeliveryTools (including this tool) into the tool registry if the smartDelivery category is enabled.

  // Register smart delivery tools if enabled
  if (enabledCategories.smartDelivery) {
    toolRegistry.registerMany(smartDeliveryTools);
  }

• src/handlers/smartDelivery.ts:98-100 (registration)

  Switch case in handleSmartDeliveryTool that routes to the specific handler for this tool.

  case 'smartlead_get_email_headers': {
    return handleGetEmailHeaders(args, apiClient, withRetry);
  }

• src/index.ts:354-355 (registration)

  Main tool dispatcher switch case that routes SMART_DELIVERY category tools to handleSmartDeliveryTool.

  case ToolCategory.SMART_DELIVERY:
    return await handleSmartDeliveryTool(name, toolArgs, apiClient, withRetry);